نام (NAME)

mmroff - پیش‌پردازنده ارجاع متقابل برای بسته ماکروی mm در groff

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

توضیحات (DESCRIPTION)

mmroff یک پیشخوان (wrapper) ساده برای groff است که به منظور بسط دادن ارجاعات داخلی در اسناد mm به کار می‌رود؛ به groff_mm(7) مراجعه کنید. این برنامه دستور groff را همراه با گزینه -mm دو بار اجرا می‌کند؛ بار نخست همراه با گزینه‌های -z و -rRef=1 برای پر کردن فایل‌های مرجع و نمایه با مدخل‌های متناظر آن‌ها، و سپس بدون آن‌ها برای تولید سند نهایی. همچنین گنجاندن تصاویر PostScript را با ماکروی PIC مدیریت می‌کند. اسنادی که از این قابلیت‌های groff mm (ماکروهای INITI، IND، INDP، INITR، SETR، GETHN، GETPN، GETR، GETST و PIC) استفاده نمی‌کنند، نیازی به mmroff ندارند.

گزینه‌ها (OPTIONS)

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

-x

فایل فهرست مراجع را ایجاد یا به‌روزرسانی کرده و خارج می‌شود.

محیط (ENVIRONMENT)

به‌طور معمول، جداکننده مسیر در متغیرهای محیطی که به PATH ختم می‌شوند، دونقطه (:) است؛ این موضوع ممکن است بسته به سیستم‌عامل متفاوت باشد. برای نمونه، ویندوز به جای آن از نقطه-ویرگول (;) استفاده می‌کند.

GROFF_BIN_PATH

دستورات groff را در این دایرکتوری‌ها جستجو می‌کند و پس از آن به سراغ موارد موجود در PATH می‌رود. در صورت عدم تنظیم، دایرکتوری محل نصب فایل‌های اجرایی GNU roff، یعنی /usr/bin، پیش از PATH جستجو می‌شود.

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

دستور mmroff با وضعیت 0 خارج می‌شود اگر گزینه‌های --help یا --version مشخص شده باشند، یا اگر گزینه -x مشخص شده باشد و برنامه با موفقیت فایل فهرست مراجع را ایجاد کرده یا به‌روزرسانی کند. این برنامه با وضعیت 1 خارج می‌شود اگر قادر به ایجاد فایل‌های لازم نباشد. در غیر این صورت، با وضعیت خروج groff خارج می‌شود.

نویسندگان (AUTHORS)

دستور mmroff توسط Jrgen Hgg از لوند، سوئد نوشته شده است.

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

groff_mm(7)، groff_mmse(7)، groff(1)، troff(1)، tbl(1)، pic(1)، eqn(1)