.\" Man page for manpath
.\"
.\" Copyright (C) 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 docs/COPYING.GPLv2 file that comes with the
.\" man-db distribution.
.\"
.\" Sun Jan 22 22:15:17 GMT 1995 Wilf. (G.Wilford@ee.surrey.ac.uk)
.\"
.pc
.TH "MANPATH" "1" "مه ۲۰۲۵" "man-db" "دستورهای کاربری"
.SH "نام (NAME)"
manpath \- تعیین مسیرهای جستجوی صفحات راهنما در سیستم
.SH "خلاصه دستور (SYNOPSIS)"
\fBmanpath\fP [\fB\-qgdc?V\fP] [\fB\-m\fP \fIسامانه\fP[,...]] [\fB\-C\fP \fIفایل\fP]
.SH "توضیحات (DESCRIPTION)"
دستور \fBmanpath\fR تلاش میکند تا مسیرهای جستجوی صفحات راهنما را بر اساس متغیرهای محیطی کاربر، فایل پیکربندی manpath.config و متغیر PATH شناسایی و چاپ کند.
.PP
اگر متغیر محیطی
.RB $ MANPATH
تنظیم شده باشد،
.B manpath
تنها محتوای آن را نمایش داده و یک هشدار صادر می‌کند.
در غیر این صورت،
.B manpath
مسیر سلسله‌مراتبی مناسب برای جستجوی صفحات راهنما را تعیین کرده و نتایج را نمایش می‌دهد.
.PP
مسیرِ جداشده با دونقطه (:)، با استفاده از اطلاعات به‌دست‌آمده از فایل پیکربندی man-db \(en
.RI ( "/etc/manpath.config" )
\(en و متغیرهای محیطی کاربر تعیین می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-q ", " \-\-quiet
عدم صدور هشدارهای غیرضروری.
.TP
.BR \-d ", " \-\-debug
چاپ اطلاعات خطایابی و دیباگ.
.TP
.BR \-c ", " \-\-catpath
تولید catpath به‌جای manpath.
پس از تعیین manpath، هر بخش از مسیر به catpath متناظر آن تبدیل می‌شود.
.TP
.BR \-g ", " \-\-global
تولید یک manpath متشکل از تمام مسیرهایی که در فایل پیکربندی man-db با برچسب "global" مشخص شده‌اند.
.TP
\fB\-m\fR \fIسامانه\fR\|[\|,.\|.\|.\|]\|, \
\fB\-\-systems=\fIسامانه\fR\|[\|,.\|.\|.\|]
اگر سیستم جاری به سلسله‌مراتب صفحات راهنمای سایر سیستم‌عامل‌ها دسترسی داشته باشد، می‌توان از این گزینه برای گنجاندن آن‌ها در خروجی
.B manpath
استفاده کرد.
برای نمونه، جهت گنجاندن سلسله‌مراتب صفحات راهنمای NewOS از گزینه
.B \-m
.B NewOS
استفاده کنید.
.IP
مقداری که برای
.I سامانه
مشخص می‌شود می‌تواند ترکیبی از نام‌های سیستم‌عامل‌ها باشد که با کاما از هم جدا شده‌اند.
برای گنجاندن سلسله‌مراتب سیستم‌عامل بومی و اصلی، باید نام سامانه
.B man
در رشته آرگومان درج شود.
این گزینه مقدار متغیر محیطی
.RB $ SYSTEM
را بازنویسی و لغو می‌کند.
.TP
.BI \-C\  فایل \fR,\ \fB\-\-config\-file= فایل
استفاده از این فایل پیکربندی کاربر به‌جای فایل پیش‌فرض در
.IR \(ti/.manpath .
.TP
.BR \-? ", " \-\-help
چاپ پیام راهنما و خروج.
.TP
.B \-\-usage
چاپ پیام کوتاه نحوه استفاده و خروج.
.TP
.BR \-V ", " \-\-version
نمایش اطلاعات نسخه برنامه.
.SH "متغیرهای محیطی (ENVIRONMENT)"
.TP
.B MANPATH
اگر
.RB $ MANPATH
تنظیم شده باشد،
.B manpath
به‌جای تعیین پویا و بلادرنگ مسیر، مقدار این متغیر را نمایش می‌دهد.
.IP
برای آگاهی از رفتار پیش‌فرض و جزئیات نحوه پردازش این متغیر محیطی، به بخش
.B SEARCH PATH
در صفحه راهنمای
.BR manpath (5)
مراجعه کنید.
.TP
.B SYSTEM
اگر متغیر
.RB $ SYSTEM
تنظیم شده باشد، همان اثری را خواهد داشت که گویی به عنوان آرگومان به گزینه
.B \-m
داده شده است.
.SH "فایل‌ها (FILES)"
.TP \w'/etc/manpath.config'u+2n
.I /etc/manpath.config
فایل پیکربندی man-db.
.SH "همچنین ببینید (SEE ALSO)"
.BR apropos (1),
.BR man (1),
.BR whatis (1)
.SH "نویسندگان (AUTHOR)"
.nf
Wilf.\& (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).
.fi
.SH "گزارش باگ‌ها (BUGS)"
https://gitlab.com/man-db/man-db/\-/issues
.br
https://savannah.nongnu.org/bugs/?group=man\-db