'\" t .\" ** The above line should force tbl to be a preprocessor ** .\" Man page for man .\" .\" Copyright (C) 1994, 1995, Graeme W. Wilford. (Wilf.) .\" Copyright (C) 2001-2019 Colin Watson. .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the file docs/COPYING.GPLv2 that comes with the .\" man-db distribution. .\" .\" Sat Oct 29 13:09:31 GMT 1994 Wilf. (G.Wilford@ee.surrey.ac.uk) .\" .pc .TH MAN 1 "2025-05-02" "2.13.1" "ابزارهای صفحه‌بندی راهنما" .SH "نام (NAME)" man \- رابطی برای راهنماهای مرجع سیستم .SH "خلاصه دستور (SYNOPSIS)" .\" The general command line .B man .RI [\| "گزینه‌های man" \|] .RI [\|[\| بخش \|] .IR صفحه \ \|.\|.\|.\|]\ \.\|.\|.\& .\" The apropos command line .br .B man .B \-k .RI [\| "گزینه‌های apropos" \|] .I عبارت_منظم \&.\|.\|.\& .\" The --global-apropos command line .br .B man .B \-K .RI [\| "گزینه‌های man" \|] .RI [\| بخش \|] .IR عبارت \ .\|.\|.\& .\" The whatis command line .br .B man .B \-f .RI [\| whatis .IR گزینه‌ها \|] .I صفحه \&.\|.\|.\& .\" The --local command line .br .B man .B \-l .RI [\| "گزینه‌های man" \|] .I پرونده \&.\|.\|.\& .\" The --where/--where-cat command line .br .B man .BR \-w \||\| \-W .RI [\| "گزینه‌های man" \|] .I صفحه \&.\|.\|.\& .SH "توضیحات (DESCRIPTION)" .B man پیجر راهنمای سیستم است. هر آرگومان .I page داده‌شده به .B man معمولاً نام یک برنامه، ابزار یا تابع است. سپس .I "صفحهٔ راهنمای" مرتبط با هر یک از این آرگومان‌ها پیدا و نمایش داده می‌شود. یک .IR section ، در صورت مشخص شدن، .B man را هدایت می‌کند تا تنها در همان .I section از راهنما جستجو کند. رفتار پیش‌فرض، جستجو در تمام .I sections موجود بر اساس ترتیبی از پیش تعیین‌شده است (نگاه کنید به .BR DEFAULTS )، و تنها نمایش نخستین .I page یافت‌شده است، حتی اگر .I page در چندین .I section وجود داشته باشد. جدول زیر شماره‌های .I section راهنما را به همراه نوع صفحاتی که در بر دارند نشان می‌دهد. .TS tab (@); l lx. 1@T{ برنامه‌های اجرایی یا دستورات پوسته T} 2@T{ فراخوان‌های سیستم (توابع ارائه‌شده توسط هسته) T} 3@T{ فراخوان‌های کتابخانه (توابع درون کتابخانه‌های برنامه) T} 4@T{ فایل‌های ویژه (معمولاً در \fI/dev\/\fR یافت می‌شوند) T} 5@T{ قالب‌های فایل و قراردادها، مانند\& \fI/etc/passwd\fR T} 6@T{ بازی‌ها T} 7@T{ متفرقه (شامل بسته‌های ماکرو و قراردادها)، مانند\& \fBman\fR(7)، \fBgroff\fR(7)، \fBman\-pages\fR(7) T} 8@T{ دستورات مدیریت سیستم (معمولاً فقط برای root) T} 9@T{ روال‌های هسته [\|غیر استاندارد\|] T} .TE یک .I "صفحهٔ راهنما" از چندین بخش تشکیل شده است. نام‌های متداول بخش‌ها شامل .BR NAME ، .BR SYNOPSIS ، .BR CONFIGURATION ، .BR DESCRIPTION ، .BR OPTIONS ، .BR EXIT\ STATUS ، .BR RETURN\ VALUE ، .BR ERRORS ، .BR ENVIRONMENT ، .BR FILES ، .BR VERSIONS ، .BR STANDARDS ، .BR NOTES ، .BR BUGS ، .BR EXAMPLE ، .BR AUTHORS ، و .BR SEE\ ALSO . قراردادهای زیر برای بخش .B SYNOPSIS اعمال می‌شوند و می‌توان از آن‌ها به عنوان راهنما در دیگر بخش‌ها نیز استفاده کرد. .TS tab (@); l lx. \fBمتن پررنگ\fR@T{ دقیقاً همان‌طور که نشان داده شده تایپ کنید. T} \fIمتن مورب\fR@T{ با آرگومان مناسب جایگزین کنید. T} [\|\fB\-abc\fR\|]@T{ هر یک یا تمام آرگومان‌های درون [ ] اختیاری هستند. T} \fB\-a\|\fR|\|\fB\-b\fR@T{ گزینه‌هایی که با | جدا شده‌اند، نمی‌توانند هم‌زمان استفاده شوند. T} \fIآرگومان\fR .\|.\|.@T{ \fIآرگومان\fR قابل تکرار است. T} [\|\fIعبارت\fR\|]\fR .\|.\|.@T{ \fRکل \fIعبارت\fR\ درون [ ] قابل تکرار است. T} .TE نمایش دقیق ممکن است بسته به دستگاه خروجی متفاوت باشد. برای نمونه، man معمولاً هنگام اجرا در ترمینال قادر به نمایش متن مورب نخواهد بود و معمولاً به جای آن از متن زیرخط‌دار یا رنگی استفاده می‌کند. نمایش دستور یا تابع، الگویی است که باید با تمام فراخوانی‌های ممکن مطابقت داشته باشد. در برخی موارد توصیه می‌شود چندین فراخوانی مانعةالجمع نشان داده شوند، همان‌طور که در بخش .B SYNOPSIS این صفحهٔ راهنما نشان داده شده است. .SH "مثالها (EXAMPLES)" .TP \w'man\ 'u .BI man \ ls نمایش صفحهٔ راهنما برای .I مورد (برنامه) .IR ls . .TP \fBman\fR \fIman\fR.\fI7\fR نمایش صفحهٔ راهنما برای بستهٔ ماکروی .I man از بخش .IR 7 . (این نگارش دیگری از "\fBman\fR \fI7 man\fR" است.) .TP \fBman '\fIman\fR(\fI7\fR)\fB' نمایش صفحهٔ راهنما برای بستهٔ ماکروی .I man از بخش .IR 7 . (این شیوه، نگارش جایگزین دیگری از "\fBman\fR \fI7 man\fR" است. ممکن است این روش هنگام رونوشت و جای‌گذاری ارجاعات متقابل به صفحات راهنما، راحت‌تر باشد. توجه داشته باشید که پرانتزها معمولاً باید نقل‌قول شوند تا در برابر شل محافظت گردند.) .TP .BI man\ \-a \ intro نمایش پیاپی تمام صفحات راهنمای موجودِ .I intro درون این راهنما. امکان خروج بین نمایش‌های پیاپی یا رد کردن هر یک از آن‌ها وجود دارد. .TP \fBman \-t \fIbash \fR|\fI lpr \-Pps قالب‌بندی صفحهٔ راهنما برای .I bash به قالب پیش‌فرض .B troff یا .B groff و ارسال آن از طریق لوله به چاپگری با نام .IR ps . خروجی پیش‌فرض برای .B groff معمولاً PostScript است. دستور .B man \-\-help باید مشخص کند که کدام پردازشگر به گزینهٔ .B \-t اختصاص یافته است. .TP .BI "man \-l \-T" "dvi ./foo.1x.gz" " > " ./foo.1x.dvi این دستور، صفحهٔ راهنمای منبع nroff .I ./foo.1x.gz را از حالت فشرده خارج کرده و به یک پروندهٔ .B device independent (dvi) قالب‌بندی می‌کند. تغییر مسیر لازم است زیرا گزینهٔ .B \-T باعث می‌شود خروجی بدون صفحه‌بند به .B stdout هدایت شود. خروجی را می‌توان با برنامه‌ای مانند .B xdvi مشاهده کرد یا با استفاده از برنامه‌ای همچون .BR dvips بیشتر پردازش کرده و به PostScript تبدیل نمود. .TP .BI man\ \-k \ printf جستجوی توضیحات کوتاه و نام صفحه‌های راهنما برای کلیدواژه .I printf به‌عنوان عبارت باقاعده. چاپ هرگونه مورد منطبق. معادل با .BI apropos \ printf . .TP .BI man\ \-f \ smail جستجوی صفحه‌های راهنمای ارجاع‌شده توسط .I smail و چاپ توضیحات کوتاه هر مورد یافت‌شده. معادل با .BI whatis \ smail . .SH "نمای کلی (OVERVIEW)" گزینه‌های متعددی برای .B man در دسترس است تا بیشترین انعطاف‌پذیری ممکن را برای کاربر فراهم کند. می‌توان تغییراتی در مسیر جستجو، ترتیب بخش‌ها، پردازنده‌ی خروجی و سایر رفتارها و عملیات‌هایی که در ادامه شرح داده شده‌اند اعمال کرد. در صورت مقداردهی، متغیرهای محیطی گوناگونی برای تعیین نحوه‌ی عملکرد .BR man بررسی می‌شوند. امکان تنظیم متغیر همه‌منظوره‌ی .RB $ MANOPT به هر رشته‌ای در قالب خط فرمان وجود دارد، با این استثنا که هر فاصله‌ای که به عنوان بخشی از آرگومان یک گزینه استفاده می‌شود باید گریز داده شود (پیش از آن یک بک‌اسلش قرار گیرد). .B man متغیر .RB $ MANOPT را پیش از تجزیه‌ی خط فرمان خود بررسی و پردازش خواهد کرد. گزینه‌هایی که نیاز به آرگومان دارند توسط گزینه‌های مشابه موجود در خط فرمان بازنویسی خواهند شد. برای بازنشانی تمام گزینه‌های تنظیم‌شده در .RB $ MANOPT , .B \-D می‌تواند به عنوان گزینه‌ی ابتدایی خط فرمان مشخص شود. این کار به man امکان می‌دهد تا گزینه‌های مشخص‌شده در .RB $ MANOPT را «فراموش» کند، هرچند که آن‌ها همچنان باید معتبر بوده باشند. صفحه‌های راهنما معمولاً در قالب .BR nroff (1) در دایرکتوری‌هایی مانند .IR /usr/share/man ذخیره می‌شوند. در برخی از نصب‌ها، ممکن است صفحه‌های پیش‌قالب‌بندی‌شده‌ی .I cat pages نیز برای بهبود کارایی وجود داشته باشند. برای اطلاع از جزئیات محل ذخیره‌سازی این فایل‌ها به .BR manpath (5) مراجعه کنید. این بسته از صفحه‌های راهنما به چندین زبان پشتیبانی می‌کند که توسط .IR locale شما کنترل می‌شود. اگر سیستم شما این مورد را به‌طور خودکار تنظیم نکرده است، ممکن است لازم باشد .RB $ LC_MESSAGES , .RB $ LANG , یا متغیر محیطی وابسته‌به‌سیستم دیگری را جهت مشخص کردن زبان و محیط محلی (locale) دلخواه خود مقداردهی کنید، که معمولاً در قالب .B POSIX مشخص می‌شود: <\fIlanguage\fR>\ [\|\fB_\fR<\fIterritory\fR>\|\ [\|\fB.\fR<\fIcharacter-set\fR>\|\ [\|\fB,\fR<\fIversion\fR>\|]\|]\|] اگر صفحه‌ی مورد نظر در .IR locale شما در دسترس باشد، به جای صفحه‌ی استاندارد (معمولاً انگلیسی آمریکایی) نمایش داده خواهد شد. اگر متوجه شدید ترجمه‌های ارائه‌شده همراه این بسته به زبان مادری شما در دسترس نیست و تمایل دارید آن‌ها را ارائه دهید، لطفاً با نگه‌دارنده‌ای که هماهنگی این فعالیت‌ها را بر عهده دارد تماس بگیرید. صفحه‌های راهنمای اختصاصی معمولاً توسط نگه‌دارندگان همان برنامه، تابع، یا موضوع دیگری که مستند می‌کنند نوشته و نگه‌داری می‌شوند و همراه با این بسته ارائه نشده‌اند. اگر مشاهده کردید یک صفحه‌ی راهنما وجود ندارد یا ناکافی است، لطفاً آن را به نگه‌دارندگان بسته‌ی مربوطه گزارش دهید. برای کسب اطلاعات درباره سایر قابلیت‌ها و افزونه‌های ارائه‌شده همراه با این صفحه‌بند راهنما، لطفاً مستندات عرضه‌شده همراه با بسته را مطالعه کنید. .SH "پیش‌فرض‌ها (DEFAULTS)" ترتیب بخش‌ها برای جستجو ممکن است توسط متغیر محیطی .RB $ MANSECT یا دستورالعمل .B SECTION در .IR /etc/man_db.conf بازنویسی شود. به‌طور پیش‌فرض به صورت زیر است: .RS 1 1p n l 8 3 3p 0 0p 2 3type 5 4 9 6 7 .RE صفحه راهنمای قالب‌بندی‌شده با استفاده از یک .IR pager نمایش داده می‌شود. این مورد را می‌توان به چندین روش مشخص کرد، در غیر این صورت به یک مقدار پیش‌فرض بازمی‌گردد (برای جزئیات به گزینه .B \-P مراجعه کنید). فیلترها از چندین طریق شناسایی می‌شوند. در ابتدا، گزینه خط فرمان .B \-p یا متغیر محیطی .RB $ MANROFFSEQ بررسی می‌شود. اگر از .B \-p استفاده نشده باشد و متغیر محیطی نیز تنظیم نشده باشد، خط نخست پرونده nroff برای یافتن رشته پیش‌پردازنده تجزیه می‌شود. برای اینکه خط نخست حاوی یک رشته پیش‌پردازنده معتبر باشد، باید شبیه به این باشد: .B '\e" .RB < string > که در آن .B string می‌تواند هر ترکیبی از حروف شرح‌داده‌شده در گزینه .B \-p در زیر باشد. اگر هیچ‌یک از روش‌های بالا اطلاعاتی درباره فیلتر ارائه ندهند، از یک مجموعه پیش‌فرض استفاده می‌شود. یک خط‌لوله قالب‌بندی از فیلترها و قالب‌بند اصلی .RB ( nroff یا .RB [ tg ] roff همراه با .BR \-t ) تشکیل شده و اجرا می‌شود. همچنین، چنانچه یک برنامه اجرایی به نام .I mandb_nfmt (یا .I mandb_tfmt همراه با .BR \-t ) در ریشه درخت man وجود داشته باشد، به جای آن اجرا می‌شود. پرونده منبع راهنما، رشته پیش‌پردازنده، و به‌صورت اختیاری دستگاه مشخص‌شده با .BR \-T " یا " \-E به عنوان آرگومان به آن ارسال می‌شوند. .\" ******************************************************************** .SH "گزینهها (OPTIONS)" تکرار گزینه‌های بدون آرگومان در خط فرمان، در .RB $ MANOPT ، یا در هر دو، مشکلی ایجاد نمی‌کند. برای گزینه‌هایی که به یک آرگومان نیاز دارند، هر بار تکرار مقدار آرگومان قبلی را بازنویسی خواهد کرد. .SS "گزینه‌های عمومی" .TP .BI \-C\ file \fR,\ \fB\-\-config\-file= file استفاده از این فایل پیکربندی کاربر به‌جای پیشفرض .IR \(ti/.manpath . .TP .BR \-d ", " \-\-debug چاپ اطلاعات اشکال‌زدایی. .TP .BR \-D ", " \-\-default این گزینه معمولاً به‌عنوان اولین گزینه داده می‌شود و رفتار .B man را به حالت پیشفرض بازمی‌گرداند. کاربرد آن، بازنشانی گزینه‌هایی است که ممکن است در .RB $ MANOPT تنظیم شده باشند. هر گزینه‌ای که پس از .B \-D بیاید، تأثیر معمول خود را خواهد داشت. .TP \fB\-\-warnings\fP[=\fIwarnings\/\fP] فعال‌سازی هشدارهای .IR groff . از این گزینه می‌توان برای بررسی صحت متن مبدأ صفحات راهنما استفاده کرد. .I warnings فهرستی از نام‌های هشدار است که با کاما از هم جدا شده‌اند؛ اگر ارائه نشود، مقدار پیشفرض "mac" است. برای غیرفعال کردن یک هشدار .I groff علامت "!" را به ابتدای آن بیفزایید: برای نمونه، .B \-\-warnings=mac,!break هشدارهای دستهٔ "mac" را فعال و هشدارهای دستهٔ "break" را غیرفعال می‌کند. برای مشاهدهٔ فهرستی از نام‌های هشدار موجود، به گره \(lqWarnings\(rq در .B info groff مراجعه کنید. .SS "حالت‌های اصلی عملیات" .TP .BR \-f ", " \-\-whatis تقریباً معادل با .BR whatis . نمایش توضیحی کوتاه از صفحهٔ راهنما، در صورت وجود. برای جزئیات، به .BR whatis (1) مراجعه کنید. .TP .BR \-k ", " \-\-apropos تقریباً معادل .BR apropos است. توضیحات کوتاه صفحات راهنما را برای کلیدواژه‌ها جست‌وجو کرده و موارد منطبق را نمایش می‌دهد. برای جزئیات بیشتر به .BR apropos (1) مراجعه کنید. .TP .BR \-K ", " \-\-global\-apropos جست‌وجوی متن در تمامی صفحات راهنما. این یک جست‌وجوی جامع و سنگین (brute-force) است و احتمالاً مدتی زمان می‌برد؛ در صورت امکان، بهتر است یک بخش را مشخص کنید تا تعداد صفحاتی که باید جست‌وجو شوند کاهش یابد. عبارات جست‌وجو می‌توانند رشته‌های متنی ساده (حالت پیش‌فرض) باشند، یا در صورتی که از گزینهٔ .B \-\-regex استفاده شود، عبارت باقاعده باشند. .IP توجه داشته باشید که این گزینه .I "پرونده‌های منبع" صفحات راهنما را جست‌وجو می‌کند، نه متن رندرشده را؛ بنابراین ممکن است شامل موارد مثبت کاذب به دلیل مواردی چون کامنت‌ها در پرونده‌های منبع، یا منفی کاذب به دلیل مواردی مانند نوشته‌شدن خط تیره به‌صورت "\e-" در پرونده‌های منبع باشد. جست‌وجوی متن رندرشده بسیار کندتر خواهد بود. .TP .BR \-l ", " \-\-local\-file فعال‌سازی حالت «محلی» (local). قالب‌بندی و نمایش پرونده‌های راهنمای محلی به‌جای جست‌وجو در مجموعه راهنماهای سیستم. هر آرگومان صفحهٔ راهنما به‌صورت یک پروندهٔ منبع nroff با ساختار صحیح تفسیر خواهد شد. .\" پرونده‌های منبع nroff فشرده‌شده با پسوند فشرده‌سازی پشتیبانی‌شده، پیش از نمایش .\" از طریق فیلترهای معمول توسط man از حالت فشرده خارج خواهند شد. هیچ پروندهٔ cat تولید نمی‌شود. اگر '\-' به‌عنوان یکی از آرگومان‌ها داده شود، ورودی از stdin خوانده خواهد شد. .IP اگر از این گزینه استفاده نشود، در صورتی که آرگومان حاوی نویسهٔ "/" باشد، .B man همچنین به تفسیر آرگومان‌های صفحهٔ راهنما به‌عنوان نام پرونده‌های محلی بازمی‌گردد، چرا که این نشانهٔ خوبی از اشارهٔ آرگومان به مسیری در سیستم پرونده است. .TP .BR \-w ", " \-\-where ", " \-\-path ", " \-\-location صفحهٔ راهنما را عملاً نمایش نمی‌دهد، بلکه مکان پروندهٔ منبع nroff را که قالب‌بندی می‌شد چاپ می‌کند. اگر گزینهٔ .B \-a نیز استفاده شود، مکان تمام پرونده‌های منبعی را که با معیارهای جست‌وجو مطابقت دارند چاپ می‌کند. .TP .BR \-W ", " \-\-where\-cat ", " \-\-location\-cat صفحهٔ راهنما را واقعاً نمایش نده، بلکه مکان پروندهٔ cat از پیش قالب‌بندی‌شده‌ای را که نمایش داده می‌شد چاپ کن. اگر گزینهٔ .B \-a نیز استفاده شود، مکان تمام پرونده‌های cat از پیش قالب‌بندی‌شده‌ای که با معیارهای جستجو مطابقت دارند را چاپ کن. .IP اگر هر دو گزینهٔ .B \-w و .B \-W استفاده شوند، هم پروندهٔ مبدأ و هم پروندهٔ cat را که با یک فاصله از هم جدا شده‌اند چاپ کن. اگر همهٔ گزینه‌های .BR \-w ، .BR \-W و .B \-a استفاده شوند، این کار را برای هر تطابق ممکن انجام بده. .TP .BR \-c ", " \-\-catman این گزینه برای استفادهٔ عمومی نیست و فقط باید توسط برنامهٔ .B catman استفاده شود. .TP .BI \-R\ encoding\fR,\ \fI \-\-recode\fR=\fIencoding به‌جای قالب‌بندی صفحهٔ راهنما به روش معمول، منبع آن را پس از تبدیل به .IR encoding مشخص‌شده خروجی بده. اگر از قبل کدگذاری پروندهٔ مبدأ را می‌دانید، می‌توانید مستقیماً از .BR manconv (1) نیز استفاده کنید. با این حال، این گزینه به شما امکان می‌دهد چندین صفحهٔ راهنما را به یک کدگذاری واحد تبدیل کنید، بدون اینکه نیاز باشد کدگذاری هر یک را به‌طور صریح مشخص کنید؛ به شرطی که آن‌ها از قبل در ساختاری مشابه با سلسله‌مراتب صفحات راهنما نصب شده باشند. .IP برای تبدیل چندین صفحهٔ راهنما، استفاده از .BR man-recode (1) را در نظر داشته باشید، چرا که رابط کاربری آن برای تبدیل گروهی طراحی شده است و می‌تواند بسیار سریع‌تر باشد. .SS "یافتن صفحات راهنما" .TP .BI \-L\ locale \fR,\ \fB\-\-locale= locale .B man به‌طور معمول تنظیمات محلی فعلی شما را با فراخوانی تابع C .BR setlocale (3) تعیین می‌کند که متغیرهای محیطی گوناگونی را بررسی می‌نماید، از جمله احتمالاً .RB $ LC_MESSAGES و .RB $ LANG . برای جایگزینی موقت مقدار تعیین‌شده، از این گزینه استفاده کنید تا یک رشتهٔ .I locale را مستقیماً به .BR man ارائه دهید. توجه داشته باشید که این گزینه تا زمانی که جستجو برای صفحات واقعاً آغاز نشود، اعمال نخواهد شد. خروجی‌هایی مانند پیام راهنما همواره در تنظیمات محلی اولیهٔ تعیین‌شده نمایش داده خواهند شد. .TP \fB\-m\fR \fIsystem\fR\|[\|,.\|.\|.\|]\|, \ \fB\-\-systems=\fIsystem\fR\|[\|,.\|.\|.\|] اگر این سیستم به صفحات راهنمای سایر سیستم‌عامل‌ها دسترسی دارد، می‌توان با استفاده از این گزینه به آن‌ها دسترسی پیدا کرد. برای جستجوی یک صفحه راهنما از مجموعه صفحات راهنمای NewOS، از گزینهٔ زیر استفاده کنید: .B \-m .BR NewOS . مقدار .I system مشخص‌شده می‌تواند ترکیبی از نام‌های سیستم‌عامل جداشده با کاما باشد. برای گنجاندن جستجو در صفحات راهنمای سیستم‌عامل بومی، نام سیستم .B man را در رشته آرگومان قرار دهید. این گزینه بر متغیر محیطی .RB $ SYSTEM اولویت خواهد داشت. .TP .BI \-M\ path \fR,\ \fB\-\-manpath= path یک manpath جایگزین را برای استفاده مشخص می‌کند. به‌طور پیش‌فرض، .B man از کد مشتق‌شده از .B manpath برای تعیین مسیر جستجو استفاده می‌کند. این گزینه بر متغیر محیطی .RB $ MANPATH اولویت دارد و باعث می‌شود گزینهٔ .B \-m نادیده گرفته شود. مسیری که به‌عنوان manpath مشخص می‌شود، باید ریشهٔ سلسله‌مراتبی از صفحات راهنما باشد که طبق توضیحات راهنمای man-db (در بخش "The manual page system")، در بخش‌های مختلف ساختار یافته است. برای مشاهدهٔ صفحات راهنما در خارج از چنین سلسله‌مراتب‌هایی، گزینهٔ .B \-l را ببینید. .TP \fB\-S\fR \fIlist\/\fR, \ \fB\-s\fR \fIlist\/\fR, \ \fB\-\-sections=\fIlist\/\fR فهرست .I list داده‌شده، فهرستی از بخش‌ها است که با دونقطه یا کاما از هم جدا شده‌اند و برای تعیین این‌که کدام بخش‌های راهنما و با چه ترتیبی جستجو شوند، به کار می‌رود. این گزینه بر متغیر محیطی .RB $ MANSECT اولویت دارد. (نگارش .B \-s برای سازگاری با System V است.) .TP .BI \-e\ sub-extension \fR,\ \fB\-\-extension= sub-extension برخی سیستم‌ها بسته‌های بزرگی از صفحات راهنما، مانند مواردی که همراه بستهٔ .B Tcl هستند را در سلسله‌مراتب اصلی صفحات راهنما ادغام می‌کنند. برای دور زدن مشکل وجود دو صفحهٔ راهنما با نام یکسان مانند .BR exit (3), معمولاً تمام صفحات .B Tcl اختصاص داده می‌شدند به بخش .BR l . از آنجا که این وضعیت نامطلوب است، اکنون می‌توان صفحات را در بخش صحیح قرار داد و یک «پسوند» خاص به آن‌ها اختصاص داد؛ در این مورد، .BR exit (3tcl). در حالت عادی، .B man صفحهٔ .BR exit (3) را نمایش می‌دهد با اولویت نسبت به .BR exit (3tcl). برای مدیریت این وضعیت و بی‌نیازی از دانستن این‌که صفحهٔ مورد نظر در کدام بخش قرار دارد، اکنون می‌توان به .B man یک رشتهٔ .I sub-extension داد که مشخص می‌کند صفحه باید متعلق به کدام بسته باشد. با استفاده از مثال بالا، دادن گزینهٔ .B \-e\ tcl به .B man جست‌وجو را محدود می‌کند به صفحاتی با پسوند .BR *tcl . .TP .BR \-i ", " \-\-ignore\-case نادیده گرفتن بزرگی و کوچکی حروف هنگام جست‌وجوی صفحات راهنما. این حالت پیش‌فرض است. .TP .BR \-I ", " \-\-match\-case جست‌وجوی حساس به بزرگی و کوچکی حروف برای صفحات راهنما. .TP .B \-\-regex نمایش تمام صفحاتی که بخشی از نام یا توضیحات آن‌ها با هر آرگومان .I page به‌عنوان یک عبارت باقاعده مطابقت دارد، مشابه .BR apropos (1). از آنجا که معمولاً هنگام جست‌وجو برای یک عبارت باقاعده راه معقولی برای انتخاب «بهترین» صفحه وجود ندارد، این گزینه دلالت دارد بر .BR \-a . .TP .B \-\-wildcard نمایش تمام صفحاتی که هر بخشی از نام یا توضیحات آن‌ها با هر آرگومان .I page با استفاده از نویسه‌های عمومی سبک پوسته مطابقت دارد، همانند .BR apropos (1) .BR \-\-wildcard . آرگومان .I page باید با کل نام یا توضیحات مطابقت داشته باشد، یا با مرزهای کلمات در توضیحات مطابقت کند. از آن‌جا که معمولاً هنگام جستجو با یک نویسه عمومی راه معقولی برای انتخاب «بهترین» صفحه وجود ندارد، این گزینه به طور ضمنی شامل این گزینه است: .BR \-a . .TP .B \-\-names\-only اگر از گزینهٔ .B \-\-regex یا .B \-\-wildcard استفاده شود، تنها نام صفحه‌ها مطابقت داده می‌شوند و نه توضیحات آن‌ها، همانند .BR whatis (1). در غیر این صورت، اثری ندارد. .TP .BR \-a ", " \-\-all به‌صورت پیش‌فرض، .B man پس از نمایش مناسب‌ترین صفحهٔ راهنمایی که می‌یابد خارج خواهد شد. استفاده از این گزینه .B man را وادار می‌کند تا تمام صفحات راهنمایی که نام آن‌ها با معیارهای جستجو مطابقت دارد را نمایش دهد. .TP .BR \-u ", " \-\-update این گزینه باعث می‌شود .B man حافظه‌های نهان پایگاه‌دادهٔ صفحات راهنمای نصب‌شدهٔ خود را به‌روزرسانی کند. این کار تنها در شرایط نادری مورد نیاز است، و معمولاً بهتر است به جای آن .BR mandb (8) اجرا شود. .TP .B \-\-no\-subpages به‌صورت پیش‌فرض، .B man تلاش می‌کند جفت‌نام‌های صفحات راهنمای داده‌شده در خط فرمان را معادل یک نام صفحهٔ راهنمای منفردِ حاوی خط تیره یا زیرخط تفسیر کند. این قابلیت از الگوی رایج برنامه‌هایی پشتیبانی می‌کند که تعدادی زیردستور را پیاده‌سازی کرده‌اند، و به آن‌ها اجازه می‌دهد برای هر یک صفحات راهنمایی ارائه دهند که با استفاده از نحوی مشابه روش فراخوانی خودِ زیردستورها قابل دسترسی باشند. برای مثال: .nf \& $ man \-aw git diff \& /usr/share/man/man1/git\-diff.1.gz .fi برای غیرفعال کردن این رفتار، از گزینهٔ .B \-\-no\-subpages استفاده کنید. .nf \& $ man \-aw \-\-no\-subpages git diff \& /usr/share/man/man1/git.1.gz \& /usr/share/man/man3/Git.3pm.gz \& /usr/share/man/man1/diff.1.gz .fi .SS "کنترل خروجی قالب‌بندی‌شده" .TP .BI \-P\ pager \fR,\ \fB\-\-pager= pager صفحه‌بندی‌کنندهٔ خروجی مورد استفاده را مشخص می‌کند. به‌طور پیش‌فرض، .B man از .BR "less" استفاده می‌کند، و در صورتی که .B less یافت نشود یا قابل اجرا نباشد، به .B cat رجوع می‌کند. این گزینه متغیر محیطی .RB $ MANPAGER را بازنویسی می‌کند، که آن نیز به‌نوبهٔ خود متغیر محیطی .RB $ PAGER را بازنویسی می‌نماید. این گزینه در کنار .B \-f یا .BR \-k استفاده نمی‌شود. مقدار می‌تواند یک نام دستور ساده یا دستوری همراه با آرگومان‌ها باشد، و می‌تواند از نقل‌قول‌گذاری‌های پوسته (بک‌اسلش، نقل‌قول تکی یا دوگانه) استفاده کند. نمی‌توان از لوله‌ها (pipes) برای اتصال چندین دستور استفاده کرد؛ اگر به چنین چیزی نیاز دارید، از یک اسکریپت پوششی (wrapper script) استفاده کنید، که می‌تواند پرونده را جهت نمایش به عنوان آرگومان یا از طریق ورودی استاندارد دریافت کند. .TP .BI \-r\ prompt \fR,\ \fB\-\-prompt= prompt اگر نسخهٔ جدیدی از .B less به‌عنوان صفحه‌بندی‌کننده استفاده شود، .B man تلاش خواهد کرد اعلان (prompt) آن و برخی گزینه‌های معقول را تنظیم کند. اعلان پیش‌فرض شبیه به این است: .BI " Manual page" " name" ( sec ") line" " x" که در آن .I name نشان‌دهندهٔ نام صفحهٔ راهنما، .I sec نشان‌دهندهٔ بخشی که صفحه در آن یافت شده، و .I x شمارهٔ خط فعلی است. .\"The default options are .\".BR \-six8 . این کار با استفاده از متغیر محیطی .RB $ LESS انجام می‌شود. .\"The actual default will depend on your chosen .\".BR locale . دادن یک رشته به .B \-r این مقدار پیش‌فرض را بازنویسی خواهد کرد. .\"You may need to do this if your .\"version of .\".B less .\"rejects the default options or if you prefer a different prompt. این رشته می‌تواند شامل متن .B $MAN_PN باشد که به نام صفحهٔ راهنمای جاری و نام بخش آن در میان «(» و «)» بسط می‌یابد. رشته‌ای که برای تولید مقدار پیش‌فرض استفاده می‌شود را می‌توان به این صورت بیان کرد: .B \e\ Manual\e\ page\e\ \e$MAN_PN\e\ ?ltline\e\ %lt?L/%L.: .br .B byte\e\ %bB?s/%s..?\e\ (END):?pB\e\ %pB\e\e%.. .br .B (press h for help or q to quit) این رشته در اینجا صرفاً برای خوانایی بیشتر به سه خط شکسته شده است. برای درک مفهوم آن، به صفحهٔ راهنمای .BR less (1) مراجعه کنید. رشتهٔ اعلان ابتدا توسط پوسته ارزیابی می‌شود. تمام علامت‌های نقل‌قول دوتایی، نقل‌قول‌های وارون (back-quotes) و بک‌اسلش‌ها در اعلان باید با یک بک‌اسلشِ پیشین گریز داده شوند (escaped). رشتهٔ اعلان ممکن است به یک $ گریز داده شده ختم شود که می‌تواند با گزینه‌های بیشتری برای less دنبال شود. به‌طور پیش‌فرض، .B man گزینه‌های .B \-ix8 را تنظیم می‌کند. متغیر محیطی .RB $ MANLESS که در ادامه توضیح داده شده است، می‌تواند برای تعیین یک رشته اعلان پیشفرض در صورت مشخص نشدن در خط فرمان به کار رود. .TP .BR \-7 ", " \-\-ascii هنگام مشاهدهٔ یک صفحهٔ راهنمای صرفاً .IR ascii (7) روی یک پایانهٔ ۷ بیتی یا شبیه‌ساز پایانه، ممکن است برخی نویسه‌ها هنگام استفاده از توصیف دستگاه .IR latin1 (7) همراه با .B GNU .BR nroff ، به‌درستی نمایش داده نشوند. این گزینه اجازه می‌دهد صفحات راهنمای صرفاً .I ascii با استفاده از دستگاه .I latin1 به صورت .I ascii نمایش داده شوند. این گزینه هیچ متن .I latin1 را تبدیل نخواهد کرد. جدول زیر تبدیل‌های انجام‌شده را نشان می‌دهد: ممکن است برخی از بخش‌های آن تنها هنگام استفاده از دستگاه .IR latin1 (7) در .B GNU .BR nroff به‌درستی نمایش داده شوند. .ie c \[shc] \ . ds softhyphen \[shc] .el \ . ds softhyphen \(hy .TS tab (@); l l l l l c c c . توضیحات@اکتال@latin1@ascii _ خط تیره ادامه@255@\*[softhyphen]@- گلوله (نقطه میانی)@267@\(bu@o اکسان اگو@264@\(aa@' علامت ضرب@327@\(mu@x .TE اگر ستون .I latin1 به‌درستی نمایش داده می‌شود، ممکن است پایانهٔ شما برای نویسه‌های .I latin1 تنظیم شده باشد و این گزینه ضروری نیست. اگر ستون‌های .I latin1 و .I ascii یکسان هستند، شما در حال خواندن این صفحه با استفاده از این گزینه هستید یا .B man این صفحه را با استفاده از توصیف دستگاه .I latin1 قالب‌بندی نکرده است. اگر ستون .I latin1 وجود ندارد یا مخدوش است، ممکن است لازم باشد صفحات راهنما را با این گزینه مشاهده کنید. این گزینه هنگام استفاده از گزینه‌های .BR \-t ، .BR \-H ، .BR \-T یا .B \-Z نادیده گرفته می‌شود و ممکن است برای .B nroff به‌جز .BR GNU بی‌استفاده باشد. .TP .BI \-E\ encoding\fR,\ \fI \-\-encoding\fR=\fIencoding تولید خروجی برای یک کدگذاری نویسه غیر از حالت پیش‌فرض. برای سازگاری با گذشته، .I encoding می‌تواند یک دستگاه .B nroff مانند .BR ascii "، " latin1 "، یا " utf8 و همچنین یک کدگذاری نویسه واقعی مانند .B UTF\-8 باشد. .TP .BR \-\-no\-hyphenation ", " \-\-nh به‌طور معمول، .B nroff اگر برای چیدمان واژه‌ها در یک خط بدون ایجاد فاصله‌های بیش از حد لازم باشد، متن را در محل شکستن سطرها حتی در کلماتی که خط پیوند ندارند، به‌طور خودکار با خط پیوند جدا می‌کند. این گزینه جداسازی خودکار با خط پیوند را غیرفعال می‌کند، بنابراین کلمات تنها در صورتی با خط پیوند جدا می‌شوند که از قبل دارای خط پیوند باشند. اگر در حال نگارش یک صفحه راهنما هستید و صرفاً می‌خواهید از شکستن یک واژه با خط پیوند در نقطه‌ای نامناسب توسط .B nroff جلوگیری کنید، از این گزینه استفاده نکنید، بلکه در عوض به مستندات .B nroff مراجعه کنید؛ برای نمونه، می‌توانید "\e%" را درون یک واژه قرار دهید تا نشان دهید می‌تواند در آن نقطه با خط پیوند شکسته شود، یا "\e%" را در ابتدای یک واژه بگذارید تا از شکستن آن با خط پیوند جلوگیری شود. .TP .BR \-\-no\-justification ", " \-\-nj به‌طور معمول، .B nroff متن را به‌طور خودکار از هر دو حاشیه تراز می‌کند. این گزینه تراز کامل را غیرفعال می‌کند و متن را تنها از حاشیه چپ تراز نگه می‌دارد، که گاهی متن «راست‌دندانه‌دار» (ragged-right) نامیده می‌شود. اگر در حال نگارش یک صفحه راهنما هستید و صرفاً می‌خواهید از تراز کردن پاراگراف‌های خاصی توسط .B nroff جلوگیری کنید، از این گزینه استفاده نکنید، بلکه در عوض به مستندات .B nroff مراجعه کنید؛ برای نمونه، می‌توانید از درخواست‌های ".na"، ".nf"، ".fi" و ".ad" برای غیرفعال کردن موقت تراز و پر کردن استفاده کنید. .TP .BI \-p\ string \fR,\ \fB\-\-preprocessor= string مشخص کردن دنباله پیش‌پردازنده‌هایی که باید پیش از .B nroff یا .BR troff / groff اجرا شوند. در همه سیستم‌ها مجموعه کاملی از پیش‌پردازنده‌ها وجود نخواهد داشت. برخی از پیش‌پردازنده‌ها و حروفی که برای تعیین آن‌ها استفاده می‌شوند عبارتند از: .BR eqn " (" e )، .BR grap " (" g )، .BR pic " (" p )، .BR tbl " (" t )، .BR vgrind " (" v )، .BR refer " (" r ). این گزینه بر متغیر محیطی .RB $ MANROFFSEQ اولویت دارد. .B zsoelim همیشه به عنوان اولین پیش‌پردازنده اجرا می‌شود. .TP .BR \-t ", " \-\-troff از .I groff \-mandoc برای قالب‌بندی صفحه راهنما در stdout استفاده می‌کند. این گزینه همراه با .BR \-H ، .BR \-T یا .BR \-Z لازم نیست. .TP \fB\-T\fP[\fIdevice\/\fP], \fB\-\-troff\-device\fP[=\fIdevice\/\fP] این گزینه برای تغییر خروجی .B groff (یا احتمالاً .BR troff ) جهت سازگاری با دستگاهی غیر از پیشفرض استفاده می‌شود. این گزینه به‌طور ضمنی .BR \-t را فعال می‌کند. مثالها (تا نسخه 1.23.0 groff) شامل موارد زیر است: .BR dvi ، .BR latin1 ، .BR pdf ، .BR ps ، .BR utf8 ، .B X75 و .BR X100 . .TP \fB\-H\fP[\fIbrowser\/\fP], \fB\-\-html\fP[=\fIbrowser\/\fP] این گزینه موجب می‌شود .B groff خروجی HTML تولید کرده و آن را در یک مرورگر وب نمایش دهد. انتخاب مرورگر با آرگومان اختیاری .I browser (در صورت ارائه)، متغیر محیطی .RB $ BROWSER یا در صورت تنظیم نبودن آن، با مقدار پیشفرض زمان کامپایل تعیین می‌شود (معمولاً .BR lynx ). این گزینه به‌طور ضمنی .BR \-t را فعال می‌کند و تنها با .B GNU .BR troff کار خواهد کرد. .TP \fB\-X\fP[\fIdpi\/\fP], \fB\-\-gxditview\fP[=\fIdpi\/\fP] این گزینه خروجی .B groff را با استفاده از برنامه .B gxditview در یک پنجره گرافیکی نمایش می‌دهد. مقدار .I dpi (نقطه در اینچ) می‌تواند 75، 75-12، 100 یا 100-12 باشد که پیشفرض آن 75 است؛ گونه‌های \-12 از یک قلم پایه 12 پوینتی استفاده می‌کنند. این گزینه به‌طور ضمنی .B \-T را به ترتیب با دستگاه‌های X75، X75-12، X100 یا X100-12 اعمال می‌کند. .TP .BR \-Z ", " \-\-ditroff .B groff دستور .B troff را اجرا کرده و سپس از یک پس‌پردازشگر مناسب برای تولید خروجی متناسب با دستگاه انتخاب‌شده استفاده می‌کند. اگر .I groff \-mandoc برابر با .BR groff باشد، این گزینه به .B groff ارسال می‌شود و از به‌کارگیری پس‌پردازشگر جلوگیری می‌کند. این گزینه مستلزم .BR \-t است. .SS "دریافت راهنما" .TP .BR \-? ", " \-\-help چاپ پیام راهنما و خروج. .TP .B \-\-usage چاپ پیام کوتاه نحوهٔ استفاده و خروج. .TP .BR \-V ", " \-\-version نمایش اطلاعات نسخه. .SH "کدهای خروج (EXIT CODES)" .TP .B 0 اجرای موفقیت‌آمیز برنامه. .TP .B 1 خطای نحوهٔ استفاده، نحو یا پروندهٔ پیکربندی. .TP .B 2 خطای عملیاتی. .TP .B 3 یک فرایند فرزند کد خروج غیرصفر بازگرداند. .TP .B 16 حداقل یکی از صفحه‌ها/پرونده‌ها/کلیدواژه‌ها وجود نداشت یا مطابقت نیافت. .SH "متغیرهای محیطی (ENVIRONMENT)" .\".TP \w'MANROFFSEQ\ \ 'u .TP .B MANPATH اگر .RB $ MANPATH تنظیم شده باشد، مقدار آن به عنوان مسیر جستجو برای صفحه‌های راهنما استفاده می‌شود. برای اطلاع از رفتار پیش‌فرض و جزئیات نحوهٔ مدیریت این متغیر محیطی، به بخش .B SEARCH PATH در .BR manpath (5) مراجعه کنید. .TP .B MANROFFOPT هر بار که .B man قالب‌بند .RB ( nroff ، .BR troff ، یا .BR groff ) را فراخوانی کند، محتوای .RB $ MANROFFOPT را به خط فرمان قالب‌بند اضافه می‌کند. برای نمونه، .B MANROFFOPT=\-P\-i به قالب‌بند می‌گوید به جای متن زیرخط‌دار، از متن مورب (که تنها در برخی پایانه‌ها پشتیبانی می‌شود) استفاده کند. .TP .B MANROFFSEQ اگر .RB $ MANROFFSEQ تنظیم شده باشد، از مقدار آن برای تعیین مجموعه پیش‌پردازنده‌هایی که هر صفحه راهنما باید از آن‌ها عبور کند، استفاده می‌شود. فهرست پیش‌فرض پیش‌پردازنده‌ها وابسته به سیستم است. .TP .B MANSECT اگر .RB $ MANSECT تنظیم شده باشد، مقدار آن فهرستی از بخش‌ها است که با دونقطه از هم جدا شده‌اند و برای تعیین این‌که کدام بخش‌های راهنما و با چه ترتیبی جستجو شوند، به کار می‌رود. مقدار پیش‌فرض "1 1p n l 8 3 3p 0 0p 2 3type 5 4 9 6 7" است، مگر این‌که توسط دستورالعمل .B SECTION در .IR /etc/man_db.conf بازنویسی شده باشد. .TP .BR MANPAGER , " PAGER" اگر .RB $ MANPAGER یا .RB $ PAGER تنظیم شده باشد .RB ($ MANPAGER در اولویت است)، از مقدار آن به عنوان نام برنامه‌ای که برای نمایش صفحه راهنما به کار می‌رود، استفاده می‌شود. به‌طور پیش‌فرض، از .B less استفاده می‌شود، و در صورتی که .B less یافت نشود یا قابل اجرا نباشد، به .B cat رجوع می‌شود. این مقدار می‌تواند نام یک دستور ساده یا دستوری همراه با آرگومان‌ها باشد، و ممکن است از نقل‌قول‌های پوسته (بک‌اسلش، نقل‌قول تکی یا نقل‌قول دوگانه) استفاده کند. نمی‌توان از لوله‌ها (pipes) برای اتصال چندین دستور استفاده کرد؛ اگر به این کار نیاز دارید، از یک اسکریپت پوششی (wrapper script) استفاده کنید که می‌تواند پرونده را جهت نمایش، چه به صورت آرگومان و چه از طریق ورودی استاندارد دریافت کند. .TP .B MANLESS اگر .RB $ MANLESS تنظیم شده باشد، مقدار آن به عنوان رشته اعلان پیش‌فرض برای صفحه‌بند .B less استفاده خواهد شد، گویی با استفاده از گزینه .B \-r ارسال شده است (بنابراین هر تکرار از متن .B $MAN_PN به همان شیوه بسط خواهد یافت). برای مثال، اگر می‌خواهید رشته اعلان را بدون قید و شرط روی \(lqmy prompt string\(rq قرار دهید، .RB $ MANLESS را تنظیم کنید به .RB \(oq \-Psmy\ prompt\ string \(cq. استفاده از گزینه .B \-r این متغیر محیطی را لغو می‌کند. .TP .B BROWSER اگر .RB $ BROWSER تنظیم شده باشد، مقدار آن فهرستی از دستورها است که با دو‌نقطه (:) از هم جدا شده‌اند؛ هر یک از آن‌ها به نوبت برای تلاش جهت راه‌اندازی مرورگر وب استفاده می‌شود برای .B man .BR \-\-html . در هر دستور، .I %s با نام پرونده‌ای حاوی خروجی HTML از .BR groff , جایگزین می‌شود، .I %% با یک علامت درصد تکی (%)، و .I %c با یک دو‌نقطه (:) جایگزین می‌گردد. .TP .B SYSTEM اگر .RB $ SYSTEM تنظیم شده باشد، همان تأثیری را خواهد داشت که گویی به عنوان آرگومان برای گزینه .B \-m مشخص شده است. .TP .B MANOPT اگر .RB $ MANOPT تنظیم شده باشد، پیش از خط فرمان .B man's تجزیه می‌شود و انتظار می‌رود که در قالبی مشابه باشد. از آنجا که سایر متغیرهای محیطی ویژه .B man همگی می‌توانند به عنوان گزینه‌های خط فرمان بیان شوند و بنابراین نامزد گنجانده شدن در .RB $ MANOPT هستند، انتظار می‌رود که منسوخ گردند. نکته: تمام فاصله‌هایی که باید به عنوان بخشی از آرگومان یک گزینه تفسیر شوند، باید گریز داده شوند. .TP .B MANWIDTH اگر .RB $ MANWIDTH تنظیم شده باشد، از مقدار آن به عنوان طول خطی که صفحات راهنما باید برای آن قالب‌بندی شوند استفاده می‌شود. اگر تنظیم نشده باشد، صفحات راهنما با طول خط متناسب با ترمینال فعلی قالب‌بندی خواهند شد (با استفاده از مقدار .RB $ COLUMNS ، و .BR ioctl (2) در صورت وجود، یا بازگشت به ۸۰ نویسه در صورتی که هیچ‌کدام در دسترس نباشند). صفحات cat تنها زمانی ذخیره خواهند شد که بتوان از قالب‌بندی پیش‌فرض استفاده کرد، یعنی زمانی که طول خط ترمینال بین ۶۶ تا ۸۰ نویسه باشد. .TP .B MAN_KEEP_FORMATTING به‌طور معمول، هنگامی که خروجی به یک ترمینال هدایت نمی‌شود (مانند هدایت به یک پرونده یا یک لوله)، نویسه‌های قالب‌بندی حذف می‌شوند تا خواندن نتیجه بدون ابزارهای ویژه آسان‌تر شود. با این حال، اگر .RB $ MAN_KEEP_FORMATTING روی هر مقدار غیرخالی تنظیم شده باشد، این نویسه‌های قالب‌بندی حفظ می‌شوند. این ویژگی ممکن است برای برنامه‌های پوشانندهٔ .B man که می‌توانند نویسه‌های قالب‌بندی را تفسیر کنند، مفید باشد. .TP .B MAN_KEEP_STDERR به‌طور معمول، هنگامی که خروجی به یک ترمینال هدایت می‌شود (معمولاً به یک صفحه‌بند)، هرگونه خروجی خطای دستوری که برای تولید نسخه‌های قالب‌بندی‌شدهٔ صفحات راهنما استفاده می‌شود دور ریخته می‌شود تا از تداخل با نمایش صفحه‌بند جلوگیری شود. برنامه‌هایی مانند .B groff اغلب پیام‌های خطای نسبتاً جزئی دربارهٔ مشکلات نگارشی و تایپوگرافی مانند تراز نامناسب تولید می‌کنند که ناخوشایند هستند و هنگام نمایش همراه با صفحهٔ راهنما معمولاً گیج‌کننده خواهند بود. با این حال، برخی کاربران مایلند آن‌ها را در هر صورت ببینند، بنابراین اگر .RB $ MAN_KEEP_STDERR روی هر مقدار غیرخالی تنظیم شود، خروجی خطا طبق معمول نمایش داده خواهد شد. .TP .B MAN_DISABLE_SECCOMP در لینوکس، .B man به‌طور معمول زیرفرآیندهایی را که داده‌های نامطمئن را مدیریت می‌کنند با استفاده از یک سندباکس .BR seccomp (2) محدود می‌کند. این امر اجرای کدهای پیچیدهٔ تجزیه را روی صفحات راهنمای دلخواه امن‌تر می‌سازد. اگر این کار به دلیلی نامرتبط با محتوای صفحهٔ در حال نمایش با مشکل مواجه شود، می‌توانید .RB $ MAN_DISABLE_SECCOMP را روی هر مقدار غیرخالی تنظیم کنید تا سندباکس غیرفعال شود. .TP .B PIPELINE_DEBUG اگر متغیر محیطی .RB $ PIPELINE_DEBUG روی "1" تنظیم شده باشد، .B man پیام‌های اشکال‌زدایی توصیف‌کننده هر زیرفرایندی را که اجرا می‌کند در خروجی خطای استاندارد چاپ خواهد کرد. .TP .BR LANG , " LC_MESSAGES" بسته به سیستم و پیاده‌سازی، یکی یا هر دوی .RB $ LANG و .RB $ LC_MESSAGES برای تنظیمات محلی فعلی پیام‌ها بررسی خواهند شد. .B man پیام‌های خود را در آن تنظیمات محلی (در صورت در دسترس بودن) نمایش خواهد داد. برای جزئیات دقیق، .BR setlocale (3) را ببینید. .SH "فایلها (FILES)" .TP .I /etc/man_db.conf فایل پیکربندی man-db. .TP .I /usr/share/man یک سلسله‌مراتب سراسری از صفحات راهنما. .SH "استانداردها (STANDARDS)" POSIX.1\-2001, POSIX.1\-2008, POSIX.1\-2017. .SH "همچنین ببینید (SEE ALSO)" .BR apropos (1), .BR groff (1), .BR less (1), .BR manpath (1), .BR nroff (1), .BR troff (1), .BR whatis (1), .BR zsoelim (1), .BR manpath (5), .BR man (7), .BR catman (8), .BR mandb (8) .PP مستندات برخی از بسته‌ها ممکن است در قالب‌های دیگری مانند .BR info (1) یا HTML در دسترس باشد. .SH "تاریخچه (HISTORY)" 1990, 1991 \(en در ابتدا توسط John W.\& Eaton (jwe@che.utexas.edu) نوشته شد. 23 دسامبر 1992: Rik Faith (faith@cs.unc.edu) رفع باگ‌های ارائه‌شده توسط Willem Kasdorp (wkasdo@nikhefk.nikef.nl) را اعمال کرد. 30 آوریل 1994 \(en 23 فوریه 2000: Wilf.\& (G.Wilford@ee.surrey.ac.uk) این بسته را با کمک چند فرد متعهد توسعه داده و نگهداری کرده است. 30 اکتبر 1996 \(en 30 مارس 2001: Fabrizio Polacco این بسته را برای پروژه Debian با کمک تمام جامعه نگهداری کرد و بهبود بخشید. 31 مارس 2001 \(en تاکنون: Colin Watson اکنون در حال توسعه و نگهداری man-db است. .SH "باگها (BUGS)" https://gitlab.com/man-db/man-db/\-/issues .br https://savannah.nongnu.org/bugs/?group=man\-db