.TH PR "1" "July 2026" "GNU coreutils 9.11" "دستورات کاربر"
.SH "نام (NAME)"
pr \- تبدیل و صفحه‌بندی فایل‌های متنی برای چاپ
.SH "خلاصه دستور (SYNOPSIS)"
.B pr
[\fI\,گزینه\/\fR]... [\fI\,فایل\/\fR]...
.SH "توضیحات (DESCRIPTION)"
.PP
صفحه‌بندی یا ستون‌بندی \fIفایل\fR(ها) برای چاپ.
.PP
در صورت عدم تعیین \fIفایل\fR، یا زمانی که \fIفایل\fR برابر \- باشد، ورودی استاندارد خوانده می‌شود.
.PP
آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.
.TP
\fB+FIRST_PAGE[:LAST_PAGE]\fR, \fB\-\-pages\fR=\fI\,FIRST_PAGE[:LAST_PAGE]\/\fR
شروع [توقف] چاپ با صفحه FIRST_[LAST_]PAGE
.TP
\fB\-COLS\fR, \fB\-\-columns\fR=\fI\,COLS\/\fR
تولید خروجی در COLS ستون و چاپ ستون‌ها به سمت پایین، مگر اینکه از \fB\-a\fR استفاده شود.
متعادل‌سازی تعداد خطوط در ستون‌های هر صفحه
.TP
\fB\-a\fR, \fB\-\-across\fR
چاپ ستون‌ها به صورت افقی (سطری) به جای عمودی (به سمت پایین)؛ همراه با \fB\-COLS\fR استفاده می‌شود
.TP
\fB\-c\fR, \fB\-\-show\-control\-chars\fR
استفاده از نمادگذاری کلاهک (^G) و نمادگذاری هشت‌هشتی با بک‌اسلش
.TP
\fB\-d\fR, \fB\-\-double\-space\fR
دو برابر کردن فاصله خطوط در خروجی
.TP
\fB\-D\fR, \fB\-\-date\-format\fR=\fI\,FORMAT\/\fR
استفاده از FORMAT برای تاریخ سربرگ
.TP
\fB\-e\fR[\fICHAR\fR[\fIWIDTH\fR]], \fB\-\-expand\-tabs\fR[=\fI\,CHAR\fR[\fIWIDTH\fR]]
بسط دادن نویسه‌های ورودی CHAR (برگه‌ها / TABها) به عرض برگه WIDTH (پیش‌فرض ۸)
.TP
\fB\-F\fR, \fB\-f\fR, \fB\-\-form\-feed\fR
استفاده از نویسه تغییر صفحه (Form Feed) به جای خط جدید برای جداسازی صفحات
(با یک سربرگ صفحه ۳ خطی با \fB\-F\fR یا سربرگ و پاورقی ۵ خطی بدون \fB\-F\fR)
.TP
\fB\-h\fR, \fB\-\-header\fR=\fI\,HEADER\/\fR
استفاده از HEADER وسط‌چین‌شده به جای نام فایل در سربرگ صفحه؛
\fB\-h\fR "" یک خط خالی چاپ می‌کند، از \fB\-h\fR"" استفاده نکنید
.TP
\fB\-i\fR[\fICHAR\fR[\fIWIDTH\fR]], \fB\-\-output\-tabs\fR[=\fI\,CHAR\fR[\fIWIDTH\fR]]
جایگزینی فاصله‌ها با نویسه‌های CHAR (برگه‌ها / TABها) با عرض برگه WIDTH (پیش‌فرض ۸)
.TP
\fB\-J\fR, \fB\-\-join\-lines\fR
ادغام کامل خطوط، غیرفعال کردن کوتاه‌سازی خطوط با \fB\-W\fR،
بدون تراز کردن ستون‌ها؛ \fB\-\-sep\-string\fR[=\fI\,STRING\/\fR] جداکننده‌ها را تعیین می‌کند
.TP
\fB\-l\fR, \fB\-\-length\fR=\fI\,PAGE_LENGTH\/\fR
تنظیم طول صفحه به PAGE_LENGTH (پیش‌فرض ۶۶) خط
(تعداد خطوط متنی پیش‌فرض ۵۶، و با \fB\-F\fR برابر ۶۳).
اگر PAGE_LENGTH <= 10 باشد، به طور ضمنی \fB\-t\fR اعمال می‌شود
.TP
\fB\-m\fR, \fB\-\-merge\fR
چاپ هم‌زمان تمام فایل‌ها، هر فایل در یک ستون؛
کوتاه‌سازی خطوط، اما با \fB\-J\fR خطوط با طول کامل متصل می‌شوند
.TP
\fB\-n\fR[\fISEP\fR[\fIDIGITS\fR]], \fB\-\-number\-lines\fR[=\fI\,SEP\fR[\fIDIGITS\fR]]
شماره‌گذاری خطوط با DIGITS رقم (پیش‌فرض ۵)، سپس SEP (پیش‌فرض TAB)؛
شمارش پیش‌فرض از خط اول فایل ورودی آغاز می‌شود
.TP
\fB\-N\fR, \fB\-\-first\-line\-number\fR=\fI\,NUMBER\/\fR
شروع شمارش با NUMBER در خط اول از نخستین صفحه چاپ‌شده (به +FIRST_PAGE مراجعه کنید)
.TP
\fB\-o\fR, \fB\-\-indent\fR=\fI\,MARGIN\/\fR
ایجاد حاشیه در ابتدای هر خط به اندازه MARGIN (پیش‌فرض صفر) فاصله؛
بر \fB\-w\fR یا \fB\-W\fR تاثیری ندارد، مقدار MARGIN به PAGE_WIDTH افزوده می‌شود
.TP
\fB\-r\fR, \fB\-\-no\-file\-warnings\fR
صرف‌نظر کردن از نمایش هشدار هنگام عدم امکان باز کردن یک فایل
.TP
\fB\-s\fR[\fICHAR\fR], \fB\-\-separator\fR[=\fI\,CHAR\/\fR]
جداسازی ستون‌ها با یک نویسه منفرد؛ مقدار پیش‌فرض برای CHAR
نویسه <TAB> بدون \fB\-w\fR و «بدون نویسه» همراه با \fB\-w\fR است.
گزینه \fB\-s\fR[\fI\,CHAR\/\fR] کوتاه‌سازی خطوط را برای هر ۳ گزینه ستونی
(\fB\-COLS\fR|\-a \fB\-COLS\fR|\-m) غیرفعال می‌کند، مگر اینکه \fB\-w\fR تعیین شده باشد
.TP
\fB\-S\fR[\fISTRING\fR], \fB\-\-sep\-string\fR[=\fI\,STRING\/\fR]
جداسازی ستون‌ها با STRING؛
بدون \fB\-S\fR: جداکننده پیش‌فرض <TAB> همراه با \fB\-J\fR و در غیر این صورت <space>
(مشابه \fB\-S\fR" ") است؛ تاثیری بر گزینه‌های ستونی ندارد
.TP
\fB\-t\fR, \fB\-\-omit\-header\fR
حذف سربرگ و پاورقی صفحات؛ اگر PAGE_LENGTH <= 10 باشد به صورت ضمنی اعمال می‌شود
.TP
\fB\-T\fR, \fB\-\-omit\-pagination\fR
حذف سربرگ و پاورقی صفحات،
و حذف هرگونه صفحه‌بندی ناشی از نویسه‌های تغییر صفحه (Form Feed) در فایل‌های ورودی
.TP
\fB\-v\fR, \fB\-\-show\-nonprinting\fR
استفاده از نمادگذاری هشت‌هشتی با بک‌اسلش
.TP
\fB\-w\fR, \fB\-\-width\fR=\fI\,PAGE_WIDTH\/\fR
تنظیم عرض صفحه به PAGE_WIDTH (پیش‌فرض ۷۲) نویسه فقط برای خروجی چندستونی متنی؛
\fB\-s\fR[\fI\,char\/\fR] مقدار پیش‌فرض (۷۲) را غیرفعال می‌کند
.TP
\fB\-W\fR, \fB\-\-page\-width\fR=\fI\,PAGE_WIDTH\/\fR
تنظیم عرض صفحه همواره به PAGE_WIDTH (پیش‌فرض ۷۲) نویسه،
کوتاه‌سازی خطوط، مگر اینکه گزینه \fB\-J\fR فعال باشد؛
بدون تداخل با \fB\-S\fR یا \fB\-s\fR
.TP
\fB\-\-help\fR
نمایش این راهنما و خروج
.TP
\fB\-\-version\fR
نمایش اطلاعات نسخه و خروج
.SH "نویسنده (AUTHOR)"
نوشته‌شده توسط Pete TerMaat و Roland Huebner.
.SH "گزارش اشکالات (REPORTING BUGS)"
گزارش اشکالات به: bug\-coreutils@gnu.org
.br
صفحه خانگی GNU coreutils: <https://www.gnu.org/software/coreutils>
.br
راهنمای عمومی استفاده از نرم‌افزارهای گنو: <https://www.gnu.org/gethelp>
.br
گزارش اشکالات ترجمه به <https://translationproject.org/team>
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2026 Free Software Foundation, Inc.
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر <https://gnu.org/licenses/gpl.html>.
.br
این نرم‌افزار آزاد است: شما مجاز به تغییر و بازتوزیع آن هستید.
هیچ ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.
.SH "همچنین ببینید (SEE ALSO)"
مستندات کامل در: <https://www.gnu.org/software/coreutils/pr>
.br
یا در دسترس به‌صورت محلی از طریق: \fBinfo \(aq(coreutils) pr invocation\(aq\fR