نام (NAME)

catman - ایجاد یا بهروزرسانی صفحات راهنمای پیشقالببندیشده

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

catman [-d?V] [-M path] [-C file] [section] ...

توضیحات (DESCRIPTION)

دستور catman برای ایجاد مجموعه‌ای بهروز از صفحات راهنمای پیشقالببندیشده که با نام صفحات cat شناخته میشوند به کار میرود. صفحات cat معمولاً بسیار سریعتر از صفحات راهنمای اصلی نمایش داده میشوند، اما به فضای ذخیرهسازی بیشتری نیاز دارند. تصمیمگیری در مورد پشتیبانی از صفحات cat بر عهده مدیر سیستم است که باید دایرکتوریهای مناسبی را برای نگهداری آنها فراهم کند.

گزینههای در دسترس برای catman شامل سلسله‌مراتبهای صفحات راهنما و بخشهایی است که باید پیشقالببندی شوند. سلسله‌مراتبهای پیشفرض مواردی هستند که به عنوان سلسله‌مراتبهای سیستمی در فایل پیکربندی man-db مشخص شدهاند، و بخشهای پیشفرض یا محتویات جداشده با دونقطه در متغیر محیطی $MANSECT هستند، یا در صورت تعریف‌نشده بودن $MANSECT، مجموعه استانداردی است که به صورت توکار در man کامپایل شده است. دادن مجموعه‌ای از نام‌های بخش که با نویسه فاصله (whitespace) از یکدیگر جدا شده‌اند به catman، هر دوی موارد فوق را بازنویسی و لغو میکند.

دستور catman از حافظه کش پایگاه‌داده index مرتبط با هر سلسله‌مراتب استفاده میکند تا مشخص کند کدام فایلها نیاز به قالببندی دارند.

گزینهها (OPTIONS)

-d, --debug: چاپ اطلاعات اشکال‌زدایی (دیباگ).
-M path, --manpath=path: تعیین یک مسیر جستجوی جایگزین برای سلسله‌مراتب صفحات راهنما که با دونقطه از هم جدا شده‌اند. به‌طور پیش‌فرض، این مقدار شامل تمام مسیرهایی است که به عنوان سلسله‌مراتب‌های سیستمی در فایل پیکربندی man-db مشخص شده‌اند.
-C file, --config-file=file: استفاده از این فایل پیکربندی کاربر به‌جای فایل پیش‌فرض در ~/.manpath.
-?, --help: چاپ پیام راهنما و خروج.
--usage: چاپ پیام کوتاه نحوه استفاده و خروج.
-V, --version: نمایش اطلاعات نسخه برنامه.

محیط (ENVIRONMENT)

MANSECT: اگر $MANSECT تنظیم شده باشد، مقدار آن فهرستی از بخش‌ها است که با دونقطه از هم جدا شده‌اند و برای تعیین این‌که کدام بخش‌های راهنما و با چه ترتیبی جستجو شوند به کار می‌رود. مقدار پیش‌فرض "1 1p n l 8 3 3p 0 0p 2 3type 5 4 9 6 7" است، مگر اینکه با دستورالعمل SECTION در /etc/man_db.conf بازنویسی شده باشد.
MANPATH: اگر $MANPATH تنظیم شده باشد، مقدار آن به عنوان مسیر جستجوی سلسله‌مراتب صفحات راهنما که با دونقطه از هم جدا شده‌اند تفسیر می‌شود.

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

فایلها (FILES)

/etc/man_db.conf: فایل پیکربندی man-db.
/usr/man/index.(bt|db|dir|pag): حافظه کش سنتی پایگاه‌داده سراسری index.
/var/catman/index.(bt|db|dir|pag): حافظه کش پایگاه‌داده سراسری جایگزین یا سازگار با FSSTND برای index.

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

man(1), manpath(5), mandb(8)

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

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

گزارش اشکال (REPORTING BUGS)

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