.\" 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 ""
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH CATMAN 8 2024-04-05 2.12.1 "Утилиты просмотра справочных страниц"
.SH НАЗВАНИЕ
catman \- создаёт или обновляет уже отформатированные справочные страницы
.SH СИНТАКСИС
\fBcatman\fP [\|\fB\-d?V\fP\|] [\|\fB\-M\fP \fIпуть\fP\|] [\|\fB\-C\fP \fIфайл\fP\|]
[\|\fIраздел\fP\|] \&.\|.\|.
.SH ОПИСАНИЕ
\fBcatman\fP используется для создания новейших отформатированных справочных
страниц, называемых cat страницами. Cat страницы, обычно, намного быстрее
отображаются, чем исходные справочные страницы, но для их хранения требуется
дополнительное место. Решение о существовании определённых cat страниц
принимает локальный администратор, который должен предоставить подходящие
каталоги для их хранения.

В параметрах \fBcatman\fP задаются иерархии справочных страниц и разделы,
которые должны быть отформатированы заранее. Иерархиями по умолчанию
считаются системные иерархии, указанные в файле настроек man\-db, а разделы
по умолчанию берутся из значения переменной окружения $\fBMANSECT\fP (список
значений через двоеточие) или из значения, заданного при компиляции
\fBman\fP, если переменная окружения $\fBMANSECT\fP не установлена. При указании
\fBcatman\fP списка имён разделов через пробельный символ, он заменит оба эти
значения по умолчанию.

При определении файлов для форматирования по каждой иерархии \fBcatman\fP
использует кэш базы данных \fBindex\fP.
.SH ПАРАМЕТРЫ
.TP 
.if  !'po4a'hide' .BR \-d ", " \-\-debug
Показывать отладочную информацию.
.TP 
\fB\-M\ \fP\fIпуть\fP,\ \fB\-\-manpath=\fP\fIпуть\fP
Задаёт альтернативный путь поиска иерархии справочных страниц (указываются
через двоеточие). По умолчанию, используются все пути, отмеченные как
системные иерархии в файле настроек man\-db.
.TP 
\fB\-C\ \fP\fIфайл\fP,\ \fB\-\-config\-file=\fP\fIфайл\fP
Использовать указанный пользовательский файл настройки вместо значения по
умолчанию \fI\(ti/.manpath\fP.
.TP 
.if  !'po4a'hide' .BR \-? ", " \-\-help
Показать справочное сообщение и закончить работу.
.TP 
.if  !'po4a'hide' .B \-\-usage
Показать короткое сообщение об использовании и завершить работу.
.TP 
.if  !'po4a'hide' .BR \-V ", " \-\-version
Показать информацию о версии.
.SH ОКРУЖЕНИЕ
.TP 
.if  !'po4a'hide' .B MANSECT
Если установлена переменная окружения $\fBMANSECT\fP, то её значением является
список разделов, указанных через двоеточие, и она используется для задания
разделов справочных страниц, в которых будет производится поиск и в каком
порядке. Значением по умолчанию является «1 n l 8 3 0 2 3type 3posix 3pm 3perl 3am 5 4 9 6 7», если оно не заменено
директивой \fBSECTION\fP в \fI/etc/manpath.config\fP.
.TP 
.if  !'po4a'hide' .B MANPATH
Если установлена переменная окружения $\fBMANPATH\fP, то она рассматривается
как набор каталогов (через двоеточие) иерархии справочных страниц для
использования при поиске.

О том, как используется эта переменная окружения и поведение по умолчанию,
смотрите раздел \fBПУТЬ ПОИСКА\fP в \fBmanpath\fP(5).
.SH ФАЙЛЫ
.TP 
.if  !'po4a'hide' .I /etc/manpath.config
Файл настройки man\-db.
.TP 
.if  !'po4a'hide' .I /usr/man/index.(bt|db|dir|pag)
Традиционный кэш глобальной базы данных \fIindex\fP.
.TP 
.if  !'po4a'hide' .I /var/catman/index.(bt|db|dir|pag)
Альтернативный или соответствующий FSSTND, глобальный кэш базы данных
\fIindex\fP.
.SH "СМОТРИТЕ ТАКЖЕ"
.if  !'po4a'hide' .BR man (1),
.if  !'po4a'hide' .BR manpath (5),
.if  !'po4a'hide' .BR mandb (8)
.SH АВТОР
.nf
.if  !'po4a'hide' Wilf.\& (G.Wilford@ee.surrey.ac.uk).
.if  !'po4a'hide' Fabrizio Polacco (fpolacco@debian.org).
.if  !'po4a'hide' Colin Watson (cjwatson@debian.org).
.fi
.SH ОШИБКИ
.if  !'po4a'hide' https://gitlab.com/man-db/man-db/-/issues
.br
.if  !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man-db