NOME¶

catman - cria ou atualiza as páginas de manual pré-formatadas

SINOPSE¶

catman [-d?V] [-M caminho] [-C arquivo] [seção] ...

DESCRIÇÃO¶

catman é usado para criar um conjunto atualizado de páginas de manual pré-formatadas conhecidas como páginas cat. Páginas cat geralmente são exibidas muito mais rapidamente que as páginas de manual originais, mas exigem espaço extra de armazenamento. A decisão para oferecer suporte páginas cat é que o administrador local, quem deve oferecer diretórios adequados par contê-los.

As opções disponíveis para catman são as hierarquias e seções de páginas de manual a serem pré-formatadas. As hierarquias padrões são aquelas especificadas como hierarquias de sistema no arquivo de configuração man-db, e as seções padrões são o conteúdo delimitado por caractere de dois pontos da variável de ambiente $MANSECT ou o conjunto padrão compilado em man se $MANSECT não estiver definido. Fornecer catman com um conjunto de nomes de seções, delimitado por espaço em branco, sobrescreverá ambos acima.

catman faz uso do cache de banco de dados index associado com cada hierarquia para determinar quais arquivos precisam ser formatadas.

OPÇÕES¶

-d, --debug

Emite mensagens de depuração.

-M caminho, --manpath=caminho

Especifica um caminho de pesquisa alternativo de hierarquia de páginas de manual delimitadas com caractere de dois pontos. Por padrão, este consiste em todos os caminhos indicados como hierarquias de sistema no arquivo de configuração do man-db.

-C arquivo, --config-file=arquivo

Use this user configuration file rather than the default of ~/.manpath.

-?, --help

Imprime uma mensagem de ajuda e sai.

--usage

Imprime uma mensagem curta e sai.

-V, --version

Exibe informação da versão.

AMBIENTE¶

MANSECT

Se $MANSECT estiver definido, seu valor é uma lista delimitada por caractere de dois pontos contendo seções que é usada para determinar quais seções de manual devem ser pesquisadas e em qual ordem. O padrã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 menos que seja sobrescrito pela diretiva SECTION em /etc/manpath.config.

MANPATH

Se $MANPATH estiver definido, seu valor é interpretado como um caminho de pesquisa de hierarquia de páginas de manual, separadas por caractere de dois pontos, a ser usado.

See the SEARCH PATH section of manpath(5) for the default behaviour and details of how this environment variable is handled.

ARQUIVOS¶

/etc/manpath.config

O arquivo de configuração do man-db.

/usr/man/index.(bt|db|dir|pag)

Um cache global de banco de dados index tradicional.

/var/catman/index.(bt|db|dir|pag)

Um cache global de banco de dados index alternativo ou compatível com 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).

PROBLEMAS¶

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