catman - cria ou actualiza as páginas do manual pré-formatadas
catman [
-d?V] [
-M caminho] [
-C
ficheiro] [
secção] ...
catman é usado para criar um conjunto actualizador de
páginas do manual pré-formatadas, conhecidas como páginas
cat. Estas são geralmente muito mais rápidas a mostrar do que as
originais páginas do manual, mas requerem mais espaço de
armazenagem. A decisão de suportar páginas cat pertence ao
administrador local, que deverá fornecer pastas adequadas para as
armazenar.
As opções disponíveis para
catman são as
hierarquias de páginas do manual e as secções a
pré-formatar. As hierarquias são as especificadas como
hierarquias do sistema no ficheiro de configuração do man-db e
as secções predefinidas são ou o conteúdo separado
por dois-pontos da variável de ambiente $
MANSECT ou o conjunto
padrão compilado com
man se $
MANSECT for indefinida.
Fornecer
catman com um conjunto de nomes de secções
separados por espaços em branco sobrepõe-se a ambas as
opções acima.
catman utiliza a cache da base de dados
índice associada
com cada hierarquia para determinar que ficheiros precisam de
formatação.
-
-d, --debug
- imprime informação de
depuração.
-
-M caminho, --manpath=caminho
- Especifica um caminho de procura alternativo separado por
dois-pontos de hierarquia de páginas do manual. Por
predefinição, são todos os caminhos indicados como
hierarquias do sistema no ficheiro de configuração do
man-db.
-
-C ficheiro, --config-file=ficheiro
- usa este ficheiro do utilizador em vez do predefinido de
~/.manpath.
-
-?, --help
- mostra uma mensagem de ajuda e sai.
- --usage
- mostra uma mensagem curta de uso e sai.
-
-V, --version
- mostra informação da versão.
- MANSECT
- Se $MANSECT estiver definida, o seu valor é
uma lista de secções separada por dois-pontos e é
usada para determinar que secções do manual procurar e em
que ordem. A predefinição é "1 n l 8 3 0 2 3type
3posix 3pm 3perl 3am 5 4 9 6 7", a não ser que sobreposta pela
directiva SECTION em /etc/manpath.config.
- MANPATH
- Se $MANPATH estiver definido, o seu valor é
interpretado como caminho de procura delimitado por dois-pontos de
hierarquia de páginas do manual a usar.
See the SEARCH PATH section of manpath(5) for the default
behaviour and details of how this environment variable is handled.
- /etc/manpath.config
- ficheiro de configuração do man-db.
- /usr/man/index.(bt|db|dir|pag)
- Uma cache de base de dados de índice global
tradicional.
- /var/catman/index.(bt|db|dir|pag)
- Uma cache de base de dados índice alternativa
ou respeitante FSSTND.
man(1),
manpath(5),
mandb(8)
Wilf. ([email protected]).
Fabrizio Polacco ([email protected]).
Colin Watson ([email protected]).
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db