نام (NAME)

pr - صفحه‌بندی یا ستون‌بندی پرونده‌ها برای چاپ

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

pr [OPTION]... [FILE]...

توضیحات (DESCRIPTION)

صفحه‌بندی یا ستون‌بندی پرونده(ها) برای چاپ.

گزینه‌ها (OPTIONS)

--pages <FIRST_PAGE[:LAST_PAGE]>: شروع و توقف چاپ با صفحه FIRST_PAGE[:LAST_PAGE].
-h, --header <STRING>: استفاده از رشته STRING به‌جای نام پرونده در سطر سربرگ.
-D, --date-format <FORMAT>: استفاده از قالب FORMAT به سبک 'date' برای تاریخ سربرگ.
-d, --double-space: تولید خروجی با فاصله‌گذاری دوبرابر سطور. پس از هر نویسه `<newline>` در ورودی، یک نویسه `<newline>` اضافی در خروجی نوشته می‌شود.
-n, --number-lines [<[char][width]>]: شماره‌گذاری خطوط با عرض width رقم. در صورت تعیین نشدن، مقدار پیش‌فرض width برابر ۵ است. این عدد، نخستین جایگاه‌های ستونی به عرض width را در هر ستون متنی یا هر سطر از خروجی -m اشغال می‌کند. اگر char (هر نویسه غیررقمی) مشخص شود، برای جداسازی شماره خط از متن پس از آن، به شماره خط الحاق می‌گردد. مقدار پیش‌فرض برای char یک نویسه `<tab>` است. شماره خطوطی که طولانی‌تر از عرض width ستون باشند کوتاه (ترانکِیت) می‌شوند.
-N, --first-line-number <NUMBER>: شروع شمارش با NUMBER در نخستین خط از اولین صفحه چاپ‌شده.
-t, --omit-header: عدم درج سربرگ ۵ خطی شناسه و پانویس ۵ خطی که معمولاً برای هر صفحه ایجاد می‌شوند. پایان نوشتن پس از آخرین سطر هر پرونده بدون افزودن فاصله تا انتهای صفحه.
-T, --omit-pagination: صرف‌نظر کردن از سربرگ‌ها و پانویس‌های صفحات و حذف هرگونه صفحه‌بندی ناشی از پرش صفحه (form feed) در پرونده‌های ورودی.
-l, --length <PAGE_LENGTH>: نادیده گرفتن طول پیش‌فرض ۶۶ سطر (تعداد پیش‌فرض سطرهای متن ۵۶ سطر، و با -F برابر ۶۳ سطر است) و بازتنظیم طول صفحه به lines سطر. اگر lines از مجموع عمق سربرگ و پانویس (بر حسب سطر) بزرگ‌تر نباشد، ابزار pr هر دو سربرگ و پانویس را حذف می‌کند، گویی گزینه -t اعمال شده است.
-r, --no-file-warnings: صرف‌نظر کردن از هشدارها در هنگامی که پرونده‌ای باز نمی‌شود.
-F, --form-feed: استفاده از `<form-feed>` برای صفحات جدید، به‌جای رفتار پیش‌فرض که از دنباله‌ای از نویسه‌های `<newline>` استفاده می‌کند.
-w, --width <width>: تنظیم عرض خط به میزان width جایگاه ستونی، فقط برای خروجی‌های متنی چندستونه. اگر گزینه -w و گزینه -s تعیین نشده باشند، عرض پیش‌فرض ۷۲ خواهد بود. اگر گزینه -w تعیین نشده باشد اما گزینه -s تعیین شده باشد، عرض پیش‌فرض ۵۱۲ خواهد بود.
-W, --page-width <width>: تنظیم همیشگی عرض صفحه به PAGE_WIDTH (۷۲) نویسه، کوتاه کردن سطرها، مگر اینکه گزینه -J تعیین شده باشد؛ بدون تداخل با -S یا -s.
-a, --across: تغییر رفتار گزینه ستون‌بندی به‌گونه‌ای که ستون‌ها در امتداد صفحه با ترتیبی نوبتی (round-robin) پر شوند (برای نمونه، هنگامی که column برابر ۲ است، نخستین سطر ورودی در بالای ستون ۱ قرار می‌گیرد، دومین سطر در بالای ستون ۲، سومی سطر دوم در ستون ۱ خواهد بود، و به همین ترتیب).
--columns <columns>: تولید خروجی چندستونه که در columns ستون مرتب شده است (پیش‌فرض ۱ است) و در هر ستون به ترتیبی که متن از پرونده ورودی دریافت می‌شود به سمت پایین نوشته می‌شود. این گزینه نباید به همراه -m استفاده شود. گزینه‌های -e و -i برای خروجی‌های متنی چندستونه مفروض دانسته می‌شوند. اینکه آیا ستون‌های متنی با طول عمودی یکسان تولید می‌شوند یا خیر مشخص نشده است، اما یک ستون متنی هرگز از طول صفحه فراتر نخواهد رفت (گزینه -l را ببینید). هنگام استفاده به همراه -t، از حداقل تعداد خطوط برای نوشتن خروجی استفاده می‌شود.
-s, --separator [<char>]: جداسازی ستون‌های متنی با تک‌نویسه char به‌جای تعداد مناسبی از نویسه‌های `<space>` (مقدار پیش‌فرض برای char نویسه `<tab>` است).
-S, --sep-string [<string>]: جداسازی ستون‌ها با رشته STRING. بدون -S: جداکننده پیش‌فرض با گزینه -J برابر `<TAB>` و در غیر این صورت برابر `<space>` است (مشابه -S\" \")؛ بدون اثرگذاری بر گزینه‌های ستون‌بندی.
-m, --merge: ادغام پرونده‌ها. خروجی استاندارد به گونه‌ای قالب‌بندی می‌شود که ابزار pr یک سطر از هر پرونده مشخص‌شده توسط عملوند پرونده را کنار هم در ستون‌های متنی با عرض‌های یکسان و ثابت، از نظر تعداد جایگاه‌های ستونی، بنویسد. پیاده‌سازی‌ها باید دست‌کم از ادغام نه عملوند پرونده پشتیبانی کنند.
-o, --indent <margin>: ابتدای هر سطر از خروجی با offset نویسه `<space>` آغاز می‌شود. اگر گزینه -o تعیین نشده باشد، مقدار آفست پیش‌فرض صفر خواهد بود. فضای اشغال‌شده اضافه بر عرض سطر خروجی است (گزینه -w را در زیر ببینید).
-J, --join-lines: ادغام کامل سطرها، غیرفعال کردن کوتاه‌سازی سطرهای -W، بدون تراز کردن ستون‌ها؛ گزینه --sep-string[=STRING] جداکننده‌ها را تعیین می‌کند.
--help: نمایش اطلاعات راهنما.
-e, --expand-tabs <[CHAR][WIDTH]>: گسترش نویسه‌های ورودی CHAR (کلیدهای TAB) به عرض تب WIDTH (پیش‌فرض ۸).
-V, --version: نمایش نسخه.
[files] [پیش‌فرض: -]

اطلاعات اضافی (EXTRA)

اگر هیچ پرونده‌ای مشخص نشده باشد، یا اگر FILE برابر با - باشد، ورودی استاندارد خوانده می‌شود.

هنگام ایجاد خروجی چندستونه، ستون‌ها دارای عرض برابری خواهند بود. هنگام استفاده از گزینه '-s' برای جداسازی ستون‌ها، جداکننده پیش‌فرض یک نویسه تب تنها است. هنگام استفاده از گزینه '-S' برای جداسازی ستون‌ها، جداکننده پیش‌فرض یک نویسه فاصله تنها است.

نسخه (VERSION)

v(uutils coreutils) 0.11.0