NOME¶

catman - cria ou actualiza as páginas do manual pré-formatadas

SINOPSE¶

catman [-d?V] [-M caminho] [-C ficheiro] [secção] ...

DESCRIÇÃ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.

OPÇÕES¶

-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

Use this user configuration file rather than the default of ~/.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.

AMBIENTE¶

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 é "0 1 n l 8 3 2 5 4 9 6 7 1x 3x 4x 5x 6x 8x 1bind 3bind 5bind 7bind 8bind 1cn 8cn 1m 1mh 5mh 8mh 1netpbm 3netpbm 5netpbm 0p 1p 3p 3posix 1pgsql 3pgsql 5pgsql 3C++ 8C++ 3blt 3curses 3ncurses 3form 3menu 3db 3gdbm 3f 3gk 3paper 3mm 5mm 3perl 3pm 3pq 3qt 3pub 3readline 1ssl 3ssl 5ssl 7ssl 3t 3tk 3tcl 3tclx 3tix 7l 7nr 8c Cg g s m", 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.

FICHEIROS¶

/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.

VEJA TAMBÉM¶

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

AUTOR¶

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

ERROS¶

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