نام (NAME)

addftinfo - افزودن اطلاعات ابعاد قلم به قلم‌های troff جهت استفاده در groff

خلاصه دستور (SYNOPSIS)

توضیحات (DESCRIPTION)

دستور addftinfo یک فایل توصیف قلم AT&T troff به نام font را خوانده، اطلاعات ابعادی قلم بیشتری را که توسط GNU troff(1) مورد نیاز است به آن می‌افزاید و نتیجه ترکیب‌شده را در جریان خروجی استاندارد می‌نویسد. اطلاعات اضافه‌شده از پارامترهای موجود قلم و فرضیات مربوط به نام‌های سنتی نویسه‌ها در troff مشتق می‌شوند. از جمله مشخصات ابعادی اضافه‌شده، ارتفاع و عمق نویسه‌ها است (اینکه هر نویسه چه مقدار به صورت عمودی در بالا و پایین خط مبنا امتداد می‌یابد). آرگومان‌های resolution و unit-width باید با پارامترهای متناظر در فایل DESC یکسان باشند. آرگومان font نام فایل توصیف‌کننده قلم است؛ اگر نام font به “I” ختم شود، فرض می‌شود که قلم مایل (یا ایتالیک) است.

گزینه‌ها (OPTIONS)

گزینه --help پیام راهنمای استفاده را نمایش می‌دهد، در حالی که -v و --version اطلاعات نگارش را نمایش می‌دهند؛ پس از آن همگی خارج می‌شوند.

تمامی گزینه‌های دیگر، پارامترهایی را تغییر می‌دهند که برای مشتق‌سازی ارتفاع و عمق‌ها به کار می‌روند. مشابه مقادیر موجود در فایل توصیف قلم، هر مقدار n بر حسب پوینت‌های مقیاس‌شده (scaled points)، یعنی inches/resolution برای قلمی با اندازه unit-width است؛ به groff_font(5) مراجعه کنید.

-asc-height n

ارتفاع نویسه‌های دارای دنباله بالارو (ascender)، مانند “b”، “d” یا “l”

-body-depth n

عمق نویسه‌هایی مانند پرانتزها

-body-height n

ارتفاع نویسه‌هایی مانند پرانتزها

-cap-height n

ارتفاع حروف بزرگ مانند “A”

-comma-depth n

عمق نویسه ویرگول (کاما)

-desc-depth n

عمق نویسه‌های دارای دنباله پایین‌رو (descender)، مانند “p”، “q” یا “y”

-fig-height

ارتفاع ارقام (اعداد)

-x-height n

ارتفاع حروف کوچک بدون دنباله بالارو مانند “x”

دستور addftinfo هیچ تلاشی برای استفاده از پارامترهای مشخص‌شده جهت استنتاج پارامترهای نامشخص انجام نمی‌دهد. اگر پارامتری مشخص نشده باشد، از مقدار پیش‌فرض استفاده خواهد شد. مقادیر پیش‌فرض به گونه‌ای انتخاب شده‌اند که مقادیر مناسبی برای قلم Times ایجاد کنند.

وضعیت خروج (EXIT STATUS)

دستور addftinfo در صورت اجرای موفقیت‌آمیز با وضعیت 0 و در صورتی که برنامه نتواند آرگومان‌های خط فرمان خود را تفسیر کند با وضعیت 2 خارج می‌شود.

همچنین ببینید (SEE ALSO)

groff_font(5), groff(1), groff_char(7)