PRG2LOUT(1) General Commands Manual PRG2LOUT(1)

prg2lout - تبدیل متن برنامه‌های رایانه‌ای به Lout

prg2lout -l language [ options ] files...

قالب‌بندی مجدد متن برنامه‌های رایانه‌ای برای ورودی به سامانه قالب‌بندی اسناد Lout، همراه با مدیریت توضیحات، رشته‌های نویسه‌ای، نویسه‌های تب و غیره.

prg2lout فایل‌های سورس برنامه مشخص‌شده را می‌خواند و خروجی مناسبی برای ورودی به lout -s تولید می‌کند. بنابراین،

prg2lout -l C foo.c | lout -s | lpr

برنامه C با نام foo.c را روی یک چاپگر PostScript چاپ خواهد کرد. هر فایل در صفحه‌ای جدید آغاز می‌شود و نام آن با قلم پررنگ در بالای صفحه درج می‌گردد.

(اجباری.) فایل‌ها به این زبان برنامه‌نویسی نوشته شده‌اند. برای مشاهده فهرست زبان‌های موجود، دستور prg2lout -u را اجرا کنید.
استفاده از قلم با عرض ثابت (پیش‌فرض برای C).
استفاده از قلم مورب (italic) با عرض متغیر به همراه کلیدواژه‌های پررنگ (bold) غیرمورب (پیش‌فرض برای Eiffel).
استفاده از قلم مورب با عرض متغیر به همراه نمادهای ریاضیاتی و کلیدواژه‌های پررنگ غیرمورب.
نام فایل پیش از متن هر فایل سورس چاپ نشود.
انتخاب خانواده قلم. پیش‌فرض برای -pfixed برابر با -fCourier است، و برای -pvarying و -psymbol برابر با -fTimes می‌باشد.
انتخاب اندازه قلم Lout. پیش‌فرض برای -pfixed، مقدار -s9p (به معنی ۹ پوینت) و برای -pvarying و -psymbol مقدار -s10p است. این اندازه‌ها برای برنامه‌هایی با پهنای ۸۰ نویسه به خوبی عمل می‌کنند.
انتخاب فاصله عمودی بین‌خطی در Lout. مقدار پیش‌فرض -v1.1fx است، به معنی ۱.۱ برابر اندازه قلم که از خط پایه تا خط پایه (baseline) محاسبه می‌شود.
انتخاب ضریب مقیاس خط خالی. مقدار پیش‌فرض -b1.0 به معنی عدم تغییر مقیاس است. یک جایگزین مناسب 0.6 است.
تنظیم فاصله تب به num نویسه (پیش‌فرض -t8 است).
بدون این گزینه، prg2lout تب‌ها را با فاصله‌ها شبیه‌سازی می‌کند. با این گزینه، prg2lout تب‌ها را با عملگرهای جدول‌بندی Lout شبیه‌سازی می‌کند؛ width عرض یک فاصله تب در چاپ نهایی است که با واحدهای Lout اندازه‌گیری می‌شود. این امر تراز بودن نویسه‌های پس از تب را حتی با قلم‌های با عرض متغیر تضمین می‌کند، به شرطی که width به اندازه کافی بزرگ باشد. برای نمونه، -T0.5i فاصله‌های تب نیم‌اینچی ایجاد می‌کند.
شماره‌گذاری خطوط متن برنامه، با شروع از number یا ۱ در صورت عدم ارائه عدد. ممکن است در هر صورت نیاز باشد مقدار ۱ را وارد کنید تا از تفسیر نام فایل بعدی به عنوان عدد توسط prg2lout جلوگیری شود.
روی خطوط خالی شماره خط چاپ نشود.
مشابه -N اما به خطوط خالی شماره خطی اختصاص داده نمی‌شود.
استفاده از filename به عنوان فایل پیکربندی به جای فایل پیکربندی پیش‌فرض سیستم. فایل پیکربندی مقادیر تمام گزینه‌های قالب‌بندی را که به عنوان آرگومان‌های خط فرمان به prg2lout داده نشده‌اند تعیین می‌کند.
چاپ اطلاعات نحوه استفاده در خطای استاندارد (stderr)، شامل زبان‌های موجود، و خروج.
چاپ اطلاعات نسخه در خطای استاندارد (stderr) و خروج.

یک کاربرد “حالت خام” برای prg2lout وجود دارد که با پرچم -r (باید نخستین آرگومان باشد) فراخوانی می‌شود. این حالت یک فایل برنامه را بدون هیچ‌گونه اطلاعات سرصفحه یا پانویس به سورس خوانا برای Lout تبدیل می‌کند. خلاصه دستور:

prg2lout -r -i infile -o out -e err -t num -T width

کاربران هرگز نباید به این حالت نیاز پیدا کنند؛ این حالت به طور خودکار از درون Lout توسط نمادهای ارائه‌شده همراه با پیکربندی استاندارد فراخوانی می‌شود (بخش مراجع را ببینید).

lout(1), lpr(1), ghostview(1).

Jeffrey H. Kingston, “A User's Guide to the Lout Document Formatting System”، فصل ۱۱.

Jeffrey H. Kingston