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.

SEARCH PATH

       By default, man-db examines the user's $PATH.  For each path_element found there, it adds manpath_element
       to the search path.

       If  there  is no MANPATH_MAP line in the configuration file for a given path_element, then it adds all of
       path_element/../man, path_element/man, path_element/../share/man, and path_element/share/man  that  exist
       as directories to the search path.

       It then adds any MANDATORY_MANPATH entries from the configuration file to the search path.

       Finally,  if  the  --systems  option is used or the $SYSTEM environment variable is set, then that should
       consist of a sequence of operating system names separated by commas or colons.  This acts as a  template,
       expanding  the  search  path once more to allow access to other operating systems' manual pages: for each
       system name, man-db looks for that name as a subdirectory of each entry in the search path, and  adds  it
       to  the  final  search  path  if  it exists.  A system name of man inserts the normal search path without
       subdirectories.  For example, if the search path would otherwise have been /usr/share/man:/usr/local/man,
       and    $SYSTEM    is    set    to    newOS:man,    then    the    final    search    path     will     be
       /usr/share/man/newOS:/usr/share/man:/usr/local/man/newOS:/usr/local/man.

       The $MANPATH environment variable overrides man-db's default manual page search paths.  Most users should
       not  need  to set it.  Its syntax is similar to the $PATH environment variable: it consists of a sequence
       of directory names separated by colons.  It overrides the default search path described above.

       If the value of $MANPATH starts with a colon, then the default search path is added at its start.  If the
       value of $MANPATH ends with a colon, then the default search path is added at its end.  If the  value  of
       $MANPATH  contains  a  double  colon  (::), then the default search path is inserted in the middle of the
       value, between the two colons.

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.

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

2.10.2                                             2022-03-17                                         MANPATH(5)