NOME

       manpath - formata o arquivo /etc/manpath.config

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

2.9.1                                              2020-02-25                                         MANPATH(5)