NOME

       manpath - formato do ficheiro /etc/manpath.config

DESCRIÇÃO

       O ficheiro de configuração de manpath é usado pelos utilitários das páginas do manual para
       avaliar os manpath do utilizador em tempo de execução, para indicar quais  as  hierarquias
       de  páginas  do  manual  (manpaths)  devem ser tratadas como hierarquias do sistema e como
       atribuir-lhes pastas a usar para armazenar ficheiros cat.

       Se a  variável  de  ambiente  $MANPATH  já  estiver  definida,  a  informação  contida  em
       /etc/manpath.config não se lhe sobrepõe.

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

       Actualmente são reconhecidos os seguintes tipos:

       # comentário
              Linhas em branco ou começadas com # serão tratadas como comentários e ignoradas.

       MANDATORY_MANPATH manpath_element
              Linhas desta forma indicam manpaths que todo o $MANPATH gerado automaticamente deve
              conter. Isto incluirá tipicamente /usr/man.

       MANPATH_MAP path_element manpath_element
              Linhas  desta  forma  configuram  $PATH para mapas $MANPATH. Para cada path_element
              encontrado no $PATH do utilizador, será adicionado manpath_element a $MANPATH.

       MANDB_MAP manpath_element [ catpath_element ]
              Linhas desta forma indicam que manpaths devem ser tratados como manpaths de sistema
              e,  opcionalmente,  onde  devem ser armazenados os seus ficheiros cat. Este tipo de
              campo é particularmente importante se man for um programa setuid, porque (quando no
              ficheiro  de  configuração  do sistema % manpath_config_file% em vez no ficheiro de
              configuração .manpath por utilizador) indica quais hierarquias de páginas do manual
              aceder como utilizador setuid e quais aceder como o utilizador chamador.

              As  hierarquias das páginas de manual do sistema estão habitualmente armazenadas em
              /usr, tal como /usr/man, /usr/local/man e /usr/X11R6/man.

              Se as páginas cat de um manpath_element não devem  ser  armazenadas  ou  devem  ser
              armazenadas na localização tradicional, catpath_element pode ser omitido.

              A  colocação  tradicional  de  cat  seria impossível para hierarquias de páginas do
              manual montadas como só de leitura e, por  causa  disto,  é   possível  especificar
              qualquer  hierarquia  válida  para  o  seu  armazenamento. Para observação de Linux
              FSSTND, a palavra-chave FSSTND pode ser usada em vez da pasta real.

              Infelizmente, é necessário especificar todos os caminhos de sistema de  árvores  do
              manual,   incluindo   caminhos  de  sistemas  operativos  alternativos,  tais  como
              /usr/man/sun e quaisquer caminhos NLS locale, tais como /usr/man/de_DE.88591.

              Como a informação é analisada linha a linha na ordem de escrita, é  necessário  que
              qualquer  manpath  que  seja  uma  sub-hierarquia  de outra hierarquia seja listado
              primeiro, senão será feita uma correspondência incorrecta. Um exemplo  disto  seria
              que /usr/man/de_DE.88591 tem de vir antes de /usr/man.

       DEFINE valor de chave
              Linhas  desta  forma definem diversas variáveis de configuração; veja o ficheiro de
              configuração predefinido para consultar as variáveis usadas pelos  utilitários  das
              páginas  do  manual.  Incluem  caminhos predefinidos para vários programas (tais co
              grep e tbl) e vários conjuntos predefinidos de argumentos para esses programas.

       SECTION secção ...
              Linhas desta forma  definem  a  ordem  em  que  as  secções  do  manual  devem  ser
              procuradas.  Se  não  houver  directivas  SECTION  no  ficheiro  de configuração, a
              predefinição é:

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

              Se forem indicadas múltiplas directivas SECTION, as suas listas  de  secções  serão
              concatenadas.

              Se uma extensão em particularnão estiver na lista (digamos, 1mh), será mostrada com
              o resto da secção a que pertence. O  efeito  disto  é  que  só  precisa  de  listar
              explicitamente  extensões  se  pretender  forçar uma determinada ordem. Secções com
              extensões devem habitualmente ser adjacentes à sua secção principal (e.g. "1 1mh  8
              ...").

              SECTIONS é aceite como nome alternativo para esta directiva.

       MINCATWIDTH largura
              Se  a  largura  do terminal for menor que largura, as páginas cat não serão criadas
              (se em falta) ou mostradas. A predefinição é 80.

       MAXCATWIDTH largura
              Se a largura do terminal for maior que largura, as páginas cat  não  serão  criadas
              (se em falta) ou mostradas. A predefinição é 80.

       CATWIDTH largura
              Se  a largura for diferente de zero, as páginas cat serão sempre formatadas para um
              terminal da largura indicada, independentemente da largura real do terminal um uso.
              Deve geralmente estar dentro do intervalo definido por MINCATWIDTH e MAXCATWIDTH.

       NOCACHE
              Esta bandeira impede que man(1) crie páginas cat automaticamente.

ERROS

       A  não  ser  que as regras acima sejam rigorosamente seguidas e observadas, os utilitários
       das páginas do manual  não  funcionarão  como  desejável.  As  regras  são  excessivamente
       complicadas.

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