.\" Use default p.i., so commented out here and in .TP
.\" .nr oi 16 \" Prevailing indentation for options' .TP request
.\" .de Sp
.\" .if n .sp
.\" .if t .sp 0.4
.\" ..
.TH LOUT 1
.SH "نام (NAME)"
lout \- آماده‌سازی سند Lout برای چاپ
.SH "خلاصه دستور (SYNOPSIS)"
\fBlout\fR [ \fIoptions\fR ] \fIfile\fR...
.SH "توضیحات (DESCRIPTION)"
مفسر Basser Lout را بر روی پیوند فایل‌های نام‌برده اجرا می‌کند و یک فایل PostScript در خروجی استاندارد تولید می‌نماید که برای چاپ بر روی چاپگرهای PostScript با استفاده از
.IR lpr (1)
مناسب است. اگر هیچ فایلی مشخص نشود، به‌جای آن از stdin استفاده می‌شود. نام فایل ویژهٔ
.RB ` \|\-\| '
می‌تواند برای نشان دادن ورودی استاندارد به کار رود. وجود فاصله (White space) میان پرچم‌ها و مقادیر گزینه‌های مربوط به آن‌ها اختیاری است.
.LP
یک پسوند اختیاری
.B .lt
می‌تواند برای فایل‌های منبع و include در Lout استفاده شود. هنگام فراخوانی فایل‌هایی که به این پسوند ختم می‌شوند، می‌توان پسوند را حذف کرد.
.SH "گزینه‌ها (OPTIONS)"
.SS "خروجی (Output)"
.TP \" \n(oi
.BI \-o " filename"
ارسال مستقیم خروجی به
.I filename
به‌جای stdout.
.TP
.BI \-e " filename"
ارسال مستقیم پیام‌های خطا به
.I filename
به‌جای stderr.
.TP
.B \-a
استفاده از قالب جایگزین پیام خطای "\c
.IR filename :\c
.IR linenum :\c
.IR colnum :\c
.I message\c
\&" (مفید در حالت کامپایل Emacs و ابزارهای دیگر).
.SS "قالب خروجی (Output format)"
.TP \" \n(oi
.B \-EPS
تولید خروجی در قالب یک فایل EPS (Encapsulated PostScript)، مناسب برای قرار گرفتن در سندی دیگر. برای تصاویر مستقل (stand-alone) مفید است.
.TP
.B \-p
تولید خروجی متن ساده (plain text) به‌جای PostScript.
.TP
.B \-P
مانند
.BR \-p ،
اما با یک نویسهٔ انتقال صفحه (form-feed) میان صفحات.
.TP
.B \-Z
تولید خروجی در قالب سند قابل‌حمل ادوبی (PDF). این قالب شامل پیوندها می‌شود، اما بسته‌های گرافیکی پیشرفته‌تر Lout پشتیبانی نمی‌شوند.
.TP
.B \-PDF
مترادف برای
.BR \-Z .
.TP
.B \-t
نادیده گرفتن گزینه‌های تغییر بافت؛ هر آنچه که در غیر این صورت با یک بافت چاپ می‌شد، با رنگ یکدست چاپ خواهد شد.
.SS "پایگاه‌داده ارجاع متقابل (Cross-reference database)"
.TP \" \n(oi
.B \-s
جلوگیری از هرگونه خواندن و نوشتن در پایگاه‌داده ارجاع متقابل؛ پایگاه‌های داده دیگر تحت تأثیر قرار نمی‌گیرند. این گزینه زمانی مفید است که اسناد سادهٔ زیادی که از ارجاع متقابل استفاده نمی‌کنند در یک دایرکتوری ذخیره شده باشند.
.TP
.B \-l
استفاده از ترتیب ASCII هنگام مرتب‌سازی مدخل‌های نمایه و غیره؛ مقدار پیش‌فرض به گزینه کامپایل COLLATE بستگی دارد (از گزینهٔ
.B \-V
برای یافتن مقدار پیش‌فرض خود استفاده کنید).
.TP
.B \-L
استفاده از ترتیب لوکال (locale) هنگام مرتب‌سازی مدخل‌های نمایه و غیره؛ مقدار پیش‌فرض به گزینه کامپایل COLLATE بستگی دارد (از گزینهٔ
.B \-V
برای یافتن مقدار پیش‌فرض خود استفاده کنید).
.SS "اجرای فیلترها (Execution of filters)"
.TP \" \n(oi
.B \-S
اجرای امن: غیرفعال کردن تمامی فراخوانی‌ها به
.IR system (3)،
و در عوض چاپ دستوراتی که قرار بود اجرا شوند. اگرچه این کار اجرای Lout را قطعاً امن می‌سازد، اما فایل خروجی PostScript ممکن است امن نباشد.
.TP
.B \-U
اجرای ناامن: مجاز دانستن فراخوانی‌ها به
.IR system (3).
این معمولاً رفتار پیش‌فرض است، اما ممکن است در هنگام نصب، اجرای امن به عنوان پیش‌فرض تعیین شده باشد (از گزینهٔ
.B \-V
برای اطلاع از این موضوع استفاده کنید)، بنابراین به این پرچم نیاز است.
.SS "تغییر گزینه‌های راه‌اندازی سند (Changing document setup options)"
.TP \" \n(oi
.BI \-\- option { value }
تنظیم گزینهٔ فایل راه‌اندازی
.I option
به
.IR value ،
که جایگزین هر مقدار اختصاص‌یافته به
.I option
در فایل راه‌اندازی می‌شود. برای نمونه،
.B \-\-@PageType{Letter}
گزینهٔ فایل راه‌اندازی
.B @PageType
را به
.BR Letter
تنظیم می‌کند. مقدار می‌تواند دنباله‌ای از کلمات باشد، اما یک شیء دلخواه Lout نیست. اگر فاصله‌ای وجود دارد، باید اطمینان حاصل کنید که به صورت یک گزینهٔ منفرد به Lout ارسال می‌شود؛ روش معمول برای این کار، قرار دادن آن در گیومه است.
.SS "جستجوی فایل‌ها (Searching for files)"
.TP \" \n(oi
.BI \-i " filename"
جستجو در دایرکتوری‌های مسیر فایل‌های include (به زیر نگاه کنید) برای
.I filename
یا
.IR filename .lt
و گنجاندن آن. می‌توان چندین گزینهٔ
.B \-i
داشت.
.TP
.BI \-I " dirname"
افزودن
.I dirname
به فهرست دایرکتوری‌های جستجو شده برای فایل‌های
.B @Include
و فایل‌های گزینهٔ
.BR \-i .
می‌توان چندین گزینهٔ
.B \-I
داشت.
.B @Include
ابتدا دایرکتوری فعلی را جستجو می‌کند، سپس دایرکتوری‌های
.B \-I
را به ترتیبی که مشخص شده‌اند جستجو می‌کند، و در پایان دایرکتوری پیش‌فرض فایل‌های include را جستجو می‌کند (به زیر نگاه کنید).
.B @SysInclude
و گزینهٔ
.B \-i
از جستجوی دایرکتوری فعلی صرف‌نظر می‌کنند.
.TP
.BI \-C " dirname"
افزودن
.I dirname
به فهرست دایرکتوری‌های جستجو شده برای فایل‌های نگاشت نویسهٔ Lout (\c
.BR .LCM ).
می‌توان چندین گزینهٔ
.B \-C
داشت؛ دایرکتوری‌ها به ترتیبی که مشخص شده‌اند جستجو می‌شوند، و در پایان دایرکتوری پیش‌فرض نگاشت‌های نویسه جستجو می‌شود (به زیر نگاه کنید).
.TP
.BI -F " dirname"
افزودن
.I dirname
به فهرست دایرکتوری‌های جستجو شده برای فایل‌های متریک قلم (پیش‌تر
.BR .AFM ).
می‌توان چندین گزینهٔ
.B \-F
داشت؛ دایرکتوری‌ها به ترتیب مشخص‌شده جستجو می‌شوند، و در پایان دایرکتوری پیش‌فرض متریک قلم جستجو می‌شود (به زیر نگاه کنید).
.TP
.BI \-H " dirname"
افزودن
.I dirname
به فهرست دایرکتوری‌های جستجو شده برای فایل‌های الگوهای خط فاصله‌گذاری (hyphenation)، هم غیرفشرده
.RB ( .lh )
و هم فشرده
.RB ( .lp ).
می‌توان چندین گزینهٔ
.B \-H
داشت؛ دایرکتوری‌ها به ترتیب مشخص‌شده جستجو می‌شوند، و در پایان دایرکتوری پیش‌فرض خط فاصله‌گذاری جستجو می‌شود (به زیر نگاه کنید).
.TP
.BI -D " dirname"
افزودن
.I dirname
به فهرست دایرکتوری‌های جستجو شده برای فایل‌های پایگاه‌دادهٔ Lout. می‌توان چندین گزینهٔ
.B \-D
داشت.
.B @Database
دایرکتوری فعلی را جستجو می‌کند، سپس دایرکتوری‌های
.B \-D
را به ترتیب مشخص‌شده، و در نهایت دایرکتوری پیش‌فرض پایگاه‌های داده را جستجو می‌کند (به زیر نگاه کنید).
.B @SysDatabase
از جستجوی دایرکتوری فعلی صرف‌نظر می‌کند.
.SS "گزینه‌های گوناگون (Miscellaneous options)"
.TP \" \n(oi
.B \-r num
اجرای Lout به تعداد num بار، در حالی که خروجی تنها در آخرین اجرا تولید می‌شود. برای به‌روزرسانی سریع ارجاع‌های متقابل مفید است.
.TP
.B \-x
اجرای مقداردهی اولیه، نه برای استفادهٔ عادی: خواندن و بررسی تمام فایل‌های قلم ذکرشده در تعاریف قلم، خواندن و بررسی تمام فایل‌های خط فاصله‌گذاری ذکرشده در تعاریف زبان و ساخت نسخه‌های فشرده، خواندن و بررسی تمام فایل‌های پایگاه‌داده ذکرشده در بندهای پایگاه‌داده و ساخت فایل‌های نمایه.
.TP
.B \-u
چاپ اطلاعات نحوهٔ استفاده روی stderr و خروج.
.TP
.B \-V
چاپ اطلاعات نسخه روی stderr و خروج.
.TP
.B \-M
استفاده از حافظهٔ کمتر و اجرای کندتر (نمایهٔ پایگاه‌داده ارجاع متقابل به‌جای حافظه در یک فایل نگهداری خواهد شد).
.TP
.B \-w
نمایش تعداد کل کلمات غیرخالی چاپ‌شده در فایل خروجی. این شامل کلمات و اعداد در سربرگ‌ها و پانویس‌های صفحه، شماره بخش‌ها و سایر اعداد، هر نویسهٔ نشانه‌گذاری با قلمی متفاوت از کلمهٔ مجاور آن، و هر قطعهٔ کوچک از هر معادله می‌شود؛ بنابراین همواره تا حدی بیشتر از تعداد واقعی تخمین می‌زند.
.SH "فایل‌ها و متغیرهای محیطی (FILES AND ENVIRONMENT VARIABLE)"
.LP
.\" NB: be careful with tabs in the table below
.nf
.ta \w'دایرکتوری پیش‌فرض فایل‌های include:  'u
\&دایرکتوری پیش‌فرض فایل‌های include:	\fILOUTLIB\fP/include
\&دایرکتوری پیش‌فرض پایگاه‌های داده:	\fILOUTLIB\fP/data
\&دایرکتوری پیش‌فرض متریک‌های قلم:	\fILOUTLIB\fP/font
\&دایرکتوری پیش‌فرض خط فاصله‌گذاری:	\fILOUTLIB\fP/hyph
\&دایرکتوری پیش‌فرض نگاشت‌های نویسه:	\fILOUTLIB\fP/maps
\&دایرکتوری پیش‌فرض لوکال‌ها:	\fILOUTLIB\fP/locale
.fi
.LP
دایرکتوری کتابخانهٔ پیش‌فرض، که معمولاً
.BR /usr/local/lib/lout
است، می‌تواند با تنظیم متغیر محیطی
.SB LOUTLIB
به یک نام دایرکتوری جایگزین تغییر یابد.
.SH "همچنین ببینید (SEE ALSO)"
.LP
.BR prg2lout (1),
.BR lpr (1),
.BR ghostview (1)
.SH "مراجع (REFERENCES)"
.LP
Jeffrey H. Kingston,
.I 
\(lq\&A User's Guide to the Lout Document Formatting System\(rq\c
\& و
.I
\(lq\&An Expert's Guide to the Lout Document Formatting System\(rq\c
\&.
.SH "نویسنده (AUTHOR)"
.LP
Jeffrey H. Kingston