MANPATH(5)

NOME
manpath - formata o arquivo /etc/man_db.conf

DESCRIÇÃO
O arquivo de configuração do manpath é usado pelos utilitários de página de manual para avaliar os caminhos man dos usuários em tempo de execução, para indicar quais hierarquias de página de manual (caminhos man) devem ser tratadas como hierarquias do sistema e para atribuí-las a diretórios para ser usados para armazenar arquivos cat. Se a variável de ambiente $MANPATH já estiver definida, as informações contidas em /etc/man_db.conf não a sobrescreverão.

FORMATO
Os seguintes tipos de campos são atualmente reconhecidos:

# comentário
    Linhas em branco ou aquelas iniciando com uma cerquilha (#) serão tratadas como comentários ou ignoradas.

MANDATORY_MANPATH manpath_element
    Linhas nesta forma indicam caminhos man que toda $MANPATH gerada automaticamente deve conter. Isso geralmente incluirá /usr/man.

MANPATH_MAP path_element manpath_element
    Linhas nesta forma configuram mapeamentos de $PATH para $MANPATH. Para cada path_element localizado no $PATH do usuários, manpath_element será adicionado ao $MANPATH.

MANDB_MAP manpath_element [ catpath_element ]
    Linhas nesta forma indicam quais caminhos man devem ser tratados como caminhos man do sistema e, opcionalmente, onde seus arquivos cat devem ser armazenados. Esse tipo de campo é particularmente importante se man é um programa setuid, como (quando no arquivo de configuração de sistema /etc/man_db.conf em vez do arquivo de configuração per-usuário .manpath) ele indica quais hierarquias de página de manual devem ser acessadas como o usuário setuid e qual como usuário invocador. As hierarquias de página de manual do sistema geralmente são aquelas armazenadas sob /usr tal como /usr/man, /usr/local/man e /usr/X11R6/man. Se páginas cat de um manpath_element em particular não devem ser armazenadas ou devem ser armazenadas na localização traducional, catpath_element pode ser omitido. Colocação de cat tradicional seria impossível para hierarquias de páginas de manual montadas como somente leituras e, por causa disso, é possível especificar qualquer hierarquia válida de diretórios para seu armazenamento. Para observar Linux FSSTND a palavra-chave FSSTND pode ser usada no lugar de um diretório real. Infelizmente, é necessário especificar todos os caminhos de árvore man do sistema, incluindo caminhos alternativos do sistema operacional, tais como /usr/man/sun e quaisquer caminhos localidade NLS tais como /usr/man/de_DE.88591. Como a informação é analisada linha por linha na ordem escrita, é necessário para qualquer caminho man que é um subdiretório de uma outra hierarquia ser listado primeiro, do contrário uma correspondência incorreta será feita. Uma exemplo disso é que /usr/man/de_DE.88591 deve vir antes de /usr/man.

DEFINE valor da chave
    Linhas nesta forma definem diversas variáveis de configuração; veja o arquivo de configuração padrão para aquelas variáveis usadas pelos utilitários paginação de manual. Eles incluem caminhos de padrão para programas variados (tais como grep e tbl) e conjuntos padrões de argumentos daqueles programas.

SECTION seção ...
    Linhas nesta forma definem a ordem na qual seções de manual devem ser pesquisadas. Caso não há diretivas SECTION no arquivo de configuração, o padrão é:

        SECTION 1 n l 8 3 0 2 5 4 9 6 7

    Se múltiplas diretivas SECTION forem fornecidas, suas listas de seções serão concatenadas.

    Se uma extensão em particular não estiver nessa lista (digamos, 1mh), ela será exibida com o resto da seção à qual ela pertence. O efeito disso é que você apenas precisa listar explicitamente extensões se você deseja forçar uma ordem em particular. As seções com extensões geralmente devem ser adjacente às suas seções principais (ex.: "1 1mh 8 ...").

    SECTIONS é aceito como um nome alternativo para essa diretiva.

MINCATWIDTH largura
    Se a largura do terminal é menor que largura, páginas cat não serão criadas (se estiverem faltando) ou exibidas. O padrão é 80.

MAXCATWIDTH largura
    Se a largura do terminal é maior que largura, páginas cat não serão criadas (se estiverem faltando) ou exibidas. O padrão é 80.

CATWIDTH largura
    Se largura é diferente de zero, páginas cat sempre serão formatadas para um terminal da largura fornecida, independente da largura usada para o terminal. Isso geralmente deve estar dentro do intervalo definido por MINCATWIDTH e MAXCATWIDTH.

NOCACHE
    Essa opção evita que man(1) crie páginas cat automaticamente.

PROBLEMAS
A menos que as regras acima sejam seguidas e observadas com muita atenção, os utilitários de paginação de manual não funcionarão como desejado. As regras são excessivamente complicadas.