نام (NAME)

manpath - تعیین مسیرهای جستجوی صفحات راهنما در سیستم

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

manpath [-qgdc?V] [-m سامانه[,...]] [-C فایل]

توضیحات (DESCRIPTION)

دستور manpath تلاش میکند تا مسیرهای جستجوی صفحات راهنما را بر اساس متغیرهای محیطی کاربر، فایل پیکربندی manpath.config و متغیر PATH شناسایی و چاپ کند.

اگر متغیر محیطی $MANPATH تنظیم شده باشد، manpath تنها محتوای آن را نمایش داده و یک هشدار صادر می‌کند. در غیر این صورت، manpath مسیر سلسله‌مراتبی مناسب برای جستجوی صفحات راهنما را تعیین کرده و نتایج را نمایش می‌دهد.

مسیرِ جداشده با دونقطه (:)، با استفاده از اطلاعات به‌دست‌آمده از فایل پیکربندی man-db – (/etc/manpath.config) – و متغیرهای محیطی کاربر تعیین می‌شود.

گزینه‌ها (OPTIONS)

-q, --quiet: عدم صدور هشدارهای غیرضروری.
-d, --debug: چاپ اطلاعات خطایابی و دیباگ.
-c, --catpath: تولید catpath به‌جای manpath. پس از تعیین manpath، هر بخش از مسیر به catpath متناظر آن تبدیل می‌شود.
-g, --global: تولید یک manpath متشکل از تمام مسیرهایی که در فایل پیکربندی man-db با برچسب "global" مشخص شده‌اند.
-m سامانه[,...], --systems=سامانه[,...]: اگر سیستم جاری به سلسله‌مراتب صفحات راهنمای سایر سیستم‌عامل‌ها دسترسی داشته باشد، می‌توان از این گزینه برای گنجاندن آن‌ها در خروجی manpath استفاده کرد. برای نمونه، جهت گنجاندن سلسله‌مراتب صفحات راهنمای NewOS از گزینه -m NewOS استفاده کنید.

: مقداری که برای سامانه مشخص می‌شود می‌تواند ترکیبی از نام‌های سیستم‌عامل‌ها باشد که با کاما از هم جدا شده‌اند. برای گنجاندن سلسله‌مراتب سیستم‌عامل بومی و اصلی، باید نام سامانه man در رشته آرگومان درج شود. این گزینه مقدار متغیر محیطی $SYSTEM را بازنویسی و لغو می‌کند.

-C فایل, --config-file=فایل: استفاده از این فایل پیکربندی کاربر به‌جای فایل پیش‌فرض در ~/.manpath.
-?, --help: چاپ پیام راهنما و خروج.
--usage: چاپ پیام کوتاه نحوه استفاده و خروج.
-V, --version: نمایش اطلاعات نسخه برنامه.

متغیرهای محیطی (ENVIRONMENT)

MANPATH: اگر $MANPATH تنظیم شده باشد، manpath به‌جای تعیین پویا و بلادرنگ مسیر، مقدار این متغیر را نمایش می‌دهد.

: برای آگاهی از رفتار پیش‌فرض و جزئیات نحوه پردازش این متغیر محیطی، به بخش SEARCH PATH در صفحه راهنمای manpath(5) مراجعه کنید.

SYSTEM: اگر متغیر $SYSTEM تنظیم شده باشد، همان اثری را خواهد داشت که گویی به عنوان آرگومان به گزینه -m داده شده است.

فایل‌ها (FILES)

/etc/manpath.config: فایل پیکربندی man-db.

همچنین ببینید (SEE ALSO)

apropos(1), man(1), whatis(1)

نویسندگان (AUTHOR)

Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).

گزارش باگ‌ها (BUGS)

https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db