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
              Usa este ficheiro de configuração do utilizador em vez do pré-definido 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.

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 é "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.

              Veja  a  secção  SEARCH  PATH  de  manpath(5) para o comportamento pré-definido e detalhes sobre a
              gestão da variável de ambiente.

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

2.13.1                                             2025-05-02                                          CATMAN(8)