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 3type 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
              If  width  is  non-zero,  cat  pages  will  always be formatted for a terminal of the given width,
              regardless of the width of the terminal actually  being  used.   This  overrides  MINCATWIDTH  and
              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/man-db/man-db/-/issues
       https://savannah.nongnu.org/bugs/?group=man-db

2.12.0                                             2023-09-23                                         MANPATH(5)