LOUT(1) General Commands Manual LOUT(1)

lout - آماده‌سازی سند Lout برای چاپ

lout [ options ] file...

مفسر Basser Lout را بر روی پیوند فایل‌های نام‌برده اجرا می‌کند و یک فایل PostScript در خروجی استاندارد تولید می‌نماید که برای چاپ بر روی چاپگرهای PostScript با استفاده از lpr(1) مناسب است. اگر هیچ فایلی مشخص نشود، به‌جای آن از stdin استفاده می‌شود. نام فایل ویژهٔ `-' می‌تواند برای نشان دادن ورودی استاندارد به کار رود. وجود فاصله (White space) میان پرچم‌ها و مقادیر گزینه‌های مربوط به آن‌ها اختیاری است.

یک پسوند اختیاری .lt می‌تواند برای فایل‌های منبع و include در Lout استفاده شود. هنگام فراخوانی فایل‌هایی که به این پسوند ختم می‌شوند، می‌توان پسوند را حذف کرد.

ارسال مستقیم خروجی به filename به‌جای stdout.
ارسال مستقیم پیام‌های خطا به filename به‌جای stderr.
استفاده از قالب جایگزین پیام خطای "filename:linenum:colnum:message" (مفید در حالت کامپایل Emacs و ابزارهای دیگر).

تولید خروجی در قالب یک فایل EPS (Encapsulated PostScript)، مناسب برای قرار گرفتن در سندی دیگر. برای تصاویر مستقل (stand-alone) مفید است.
تولید خروجی متن ساده (plain text) به‌جای PostScript.
مانند -p، اما با یک نویسهٔ انتقال صفحه (form-feed) میان صفحات.
تولید خروجی در قالب سند قابل‌حمل ادوبی (PDF). این قالب شامل پیوندها می‌شود، اما بسته‌های گرافیکی پیشرفته‌تر Lout پشتیبانی نمی‌شوند.
مترادف برای -Z.
نادیده گرفتن گزینه‌های تغییر بافت؛ هر آنچه که در غیر این صورت با یک بافت چاپ می‌شد، با رنگ یکدست چاپ خواهد شد.

جلوگیری از هرگونه خواندن و نوشتن در پایگاه‌داده ارجاع متقابل؛ پایگاه‌های داده دیگر تحت تأثیر قرار نمی‌گیرند. این گزینه زمانی مفید است که اسناد سادهٔ زیادی که از ارجاع متقابل استفاده نمی‌کنند در یک دایرکتوری ذخیره شده باشند.
استفاده از ترتیب ASCII هنگام مرتب‌سازی مدخل‌های نمایه و غیره؛ مقدار پیش‌فرض به گزینه کامپایل COLLATE بستگی دارد (از گزینهٔ -V برای یافتن مقدار پیش‌فرض خود استفاده کنید).
استفاده از ترتیب لوکال (locale) هنگام مرتب‌سازی مدخل‌های نمایه و غیره؛ مقدار پیش‌فرض به گزینه کامپایل COLLATE بستگی دارد (از گزینهٔ -V برای یافتن مقدار پیش‌فرض خود استفاده کنید).

اجرای امن: غیرفعال کردن تمامی فراخوانی‌ها به system(3)، و در عوض چاپ دستوراتی که قرار بود اجرا شوند. اگرچه این کار اجرای Lout را قطعاً امن می‌سازد، اما فایل خروجی PostScript ممکن است امن نباشد.
اجرای ناامن: مجاز دانستن فراخوانی‌ها به system(3). این معمولاً رفتار پیش‌فرض است، اما ممکن است در هنگام نصب، اجرای امن به عنوان پیش‌فرض تعیین شده باشد (از گزینهٔ -V برای اطلاع از این موضوع استفاده کنید)، بنابراین به این پرچم نیاز است.

--option{value}
تنظیم گزینهٔ فایل راه‌اندازی option به value، که جایگزین هر مقدار اختصاص‌یافته به option در فایل راه‌اندازی می‌شود. برای نمونه، --@PageType{Letter} گزینهٔ فایل راه‌اندازی @PageType را به Letter تنظیم می‌کند. مقدار می‌تواند دنباله‌ای از کلمات باشد، اما یک شیء دلخواه Lout نیست. اگر فاصله‌ای وجود دارد، باید اطمینان حاصل کنید که به صورت یک گزینهٔ منفرد به Lout ارسال می‌شود؛ روش معمول برای این کار، قرار دادن آن در گیومه است.

جستجو در دایرکتوری‌های مسیر فایل‌های include (به زیر نگاه کنید) برای filename یا filename.lt و گنجاندن آن. می‌توان چندین گزینهٔ -i داشت.
افزودن dirname به فهرست دایرکتوری‌های جستجو شده برای فایل‌های @Include و فایل‌های گزینهٔ -i. می‌توان چندین گزینهٔ -I داشت. @Include ابتدا دایرکتوری فعلی را جستجو می‌کند، سپس دایرکتوری‌های -I را به ترتیبی که مشخص شده‌اند جستجو می‌کند، و در پایان دایرکتوری پیش‌فرض فایل‌های include را جستجو می‌کند (به زیر نگاه کنید). @SysInclude و گزینهٔ -i از جستجوی دایرکتوری فعلی صرف‌نظر می‌کنند.
افزودن dirname به فهرست دایرکتوری‌های جستجو شده برای فایل‌های نگاشت نویسهٔ Lout (.LCM). می‌توان چندین گزینهٔ -C داشت؛ دایرکتوری‌ها به ترتیبی که مشخص شده‌اند جستجو می‌شوند، و در پایان دایرکتوری پیش‌فرض نگاشت‌های نویسه جستجو می‌شود (به زیر نگاه کنید).
افزودن dirname به فهرست دایرکتوری‌های جستجو شده برای فایل‌های متریک قلم (پیش‌تر .AFM). می‌توان چندین گزینهٔ -F داشت؛ دایرکتوری‌ها به ترتیب مشخص‌شده جستجو می‌شوند، و در پایان دایرکتوری پیش‌فرض متریک قلم جستجو می‌شود (به زیر نگاه کنید).
افزودن dirname به فهرست دایرکتوری‌های جستجو شده برای فایل‌های الگوهای خط فاصله‌گذاری (hyphenation)، هم غیرفشرده (.lh) و هم فشرده (.lp). می‌توان چندین گزینهٔ -H داشت؛ دایرکتوری‌ها به ترتیب مشخص‌شده جستجو می‌شوند، و در پایان دایرکتوری پیش‌فرض خط فاصله‌گذاری جستجو می‌شود (به زیر نگاه کنید).
افزودن dirname به فهرست دایرکتوری‌های جستجو شده برای فایل‌های پایگاه‌دادهٔ Lout. می‌توان چندین گزینهٔ -D داشت. @Database دایرکتوری فعلی را جستجو می‌کند، سپس دایرکتوری‌های -D را به ترتیب مشخص‌شده، و در نهایت دایرکتوری پیش‌فرض پایگاه‌های داده را جستجو می‌کند (به زیر نگاه کنید). @SysDatabase از جستجوی دایرکتوری فعلی صرف‌نظر می‌کند.

اجرای Lout به تعداد num بار، در حالی که خروجی تنها در آخرین اجرا تولید می‌شود. برای به‌روزرسانی سریع ارجاع‌های متقابل مفید است.
اجرای مقداردهی اولیه، نه برای استفادهٔ عادی: خواندن و بررسی تمام فایل‌های قلم ذکرشده در تعاریف قلم، خواندن و بررسی تمام فایل‌های خط فاصله‌گذاری ذکرشده در تعاریف زبان و ساخت نسخه‌های فشرده، خواندن و بررسی تمام فایل‌های پایگاه‌داده ذکرشده در بندهای پایگاه‌داده و ساخت فایل‌های نمایه.
چاپ اطلاعات نحوهٔ استفاده روی stderr و خروج.
چاپ اطلاعات نسخه روی stderr و خروج.
استفاده از حافظهٔ کمتر و اجرای کندتر (نمایهٔ پایگاه‌داده ارجاع متقابل به‌جای حافظه در یک فایل نگهداری خواهد شد).
نمایش تعداد کل کلمات غیرخالی چاپ‌شده در فایل خروجی. این شامل کلمات و اعداد در سربرگ‌ها و پانویس‌های صفحه، شماره بخش‌ها و سایر اعداد، هر نویسهٔ نشانه‌گذاری با قلمی متفاوت از کلمهٔ مجاور آن، و هر قطعهٔ کوچک از هر معادله می‌شود؛ بنابراین همواره تا حدی بیشتر از تعداد واقعی تخمین می‌زند.

دایرکتوری پیش‌فرض فایل‌های include:	LOUTLIB/include
دایرکتوری پیش‌فرض پایگاه‌های داده:	LOUTLIB/data
دایرکتوری پیش‌فرض متریک‌های قلم:	LOUTLIB/font
دایرکتوری پیش‌فرض خط فاصله‌گذاری:	LOUTLIB/hyph
دایرکتوری پیش‌فرض نگاشت‌های نویسه:	LOUTLIB/maps
دایرکتوری پیش‌فرض لوکال‌ها:	LOUTLIB/locale

دایرکتوری کتابخانهٔ پیش‌فرض، که معمولاً /usr/local/lib/lout است، می‌تواند با تنظیم متغیر محیطی LOUTLIB به یک نام دایرکتوری جایگزین تغییر یابد.

prg2lout(1), lpr(1), ghostview(1)

Jeffrey H. Kingston, “A User's Guide to the Lout Document Formatting System” و “An Expert's Guide to the Lout Document Formatting System”.

Jeffrey H. Kingston