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.