.\" Man page for catman
.\"
.\" Copyright (C), 1994, 1995, Graeme W. Wilford. (Wilf.)
.\"
.\" 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 Dec 10 14:17:29 GMT 1994  Wilf. (G.Wilford@ee.surrey.ac.uk)
.\"
.pc
.TH CATMAN 8 "2025-05-02" "2.13.1" "Manual pager utils"
.SH "نام (NAME)"
catman \- ایجاد یا بهروزرسانی صفحات راهنمای پیشقالببندیشده
.SH "خلاصه دستور (SYNOPSIS)"
.B catman
.RB [\| \-d?V \|]
.RB [\| \-M
.IR path \|]
.RB [\| \-C
.IR file \|]
.RI [\| section \|]
\&.\|.\|.
.SH "توضیحات (DESCRIPTION)"
دستور
.B catman
برای ایجاد مجموعه‌ای بهروز از صفحات راهنمای پیشقالببندیشده که با نام صفحات cat شناخته میشوند به کار میرود.
صفحات cat معمولاً بسیار سریعتر از صفحات راهنمای اصلی نمایش داده میشوند، اما به فضای ذخیرهسازی بیشتری نیاز دارند.
تصمیمگیری در مورد پشتیبانی از صفحات cat بر عهده مدیر سیستم است که باید دایرکتوریهای مناسبی را برای نگهداری آنها فراهم کند.
.PP
گزینههای در دسترس برای
.B catman
شامل سلسله‌مراتبهای صفحات راهنما و بخشهایی است که باید پیشقالببندی شوند.
سلسله‌مراتبهای پیشفرض مواردی هستند که به عنوان سلسله‌مراتبهای سیستمی در فایل پیکربندی man-db مشخص شدهاند، و بخشهای پیشفرض یا محتویات جداشده با دونقطه در متغیر محیطی
.RB $ MANSECT
هستند، یا در صورت تعریف‌نشده بودن
.RB $ MANSECT ،
مجموعه استانداردی است که به صورت توکار در
.B man
کامپایل شده است.
دادن مجموعه‌ای از نام‌های بخش که با نویسه فاصله (whitespace) از یکدیگر جدا شده‌اند به
.BR catman ،
هر دوی موارد فوق را بازنویسی و لغو میکند.
.PP
دستور
.B catman
از حافظه کش پایگاه‌داده
.B index
مرتبط با هر سلسله‌مراتب استفاده میکند تا مشخص کند کدام فایلها نیاز به قالببندی دارند.
.SH "گزینهها (OPTIONS)"
.TP
.BR \-d ", " \-\-debug
چاپ اطلاعات اشکال‌زدایی (دیباگ).
.TP
.BI \-M\  path \fR,\ \fB\-\-manpath= path
تعیین یک مسیر جستجوی جایگزین برای سلسله‌مراتب صفحات راهنما که با دونقطه از هم جدا شده‌اند.
به‌طور پیش‌فرض، این مقدار شامل تمام مسیرهایی است که به عنوان سلسله‌مراتب‌های سیستمی در فایل پیکربندی man-db مشخص شده‌اند.
.TP
.BI \-C\  file \fR,\ \fB\-\-config\-file= file
استفاده از این فایل پیکربندی کاربر به‌جای فایل پیش‌فرض در
.IR \(ti/.manpath .
.TP
.BR \-? ", " \-\-help
چاپ پیام راهنما و خروج.
.TP
.B \-\-usage
چاپ پیام کوتاه نحوه استفاده و خروج.
.TP
.BR \-V ", " \-\-version
نمایش اطلاعات نسخه برنامه.
.SH "محیط (ENVIRONMENT)"
.TP
.B MANSECT
اگر
.RB $ MANSECT
تنظیم شده باشد، مقدار آن فهرستی از بخش‌ها است که با دونقطه از هم جدا شده‌اند و برای تعیین این‌که کدام بخش‌های راهنما و با چه ترتیبی جستجو شوند به کار می‌رود.
مقدار پیش‌فرض "1 1p n l 8 3 3p 0 0p 2 3type 5 4 9 6 7" است، مگر اینکه با دستورالعمل
.B SECTION
در
.I /etc/man_db.conf
بازنویسی شده باشد.
.TP
.B MANPATH
اگر
.RB $ MANPATH
تنظیم شده باشد، مقدار آن به عنوان مسیر جستجوی سلسله‌مراتب صفحات راهنما که با دونقطه از هم جدا شده‌اند تفسیر می‌شود.
.PP
برای اطلاع از رفتار پیش‌فرض و جزئیات نحوه پردازش این متغیر محیطی، به بخش
.B SEARCH PATH
در صفحه راهنمای
.BR manpath (5)
مراجعه کنید.
.SH "فایلها (FILES)"
.TP
.I /etc/man_db.conf
فایل پیکربندی man-db.
.TP
.I /usr/man/index.(bt|db|dir|pag)
حافظه کش سنتی پایگاه‌داده سراسری
.IR index .
.TP
.I /var/catman/index.(bt|db|dir|pag)
حافظه کش پایگاه‌داده سراسری جایگزین یا سازگار با FSSTND برای
.IR index .
.SH "همچنین ببینید (SEE ALSO)"
.BR man (1),
.BR manpath (5),
.BR mandb (8)
.SH "نویسندگان (AUTHORS)"
.nf
Wilf.\& (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).
.fi
.SH "گزارش اشکال (REPORTING BUGS)"
https://gitlab.com/man-db/man-db/\-/issues
.br
https://savannah.nongnu.org/bugs/?group=man\-db