.\" Man page for format of the manpath.config data file
.\"
.\" Copyright (C) 1994, 1995 Graeme W. Wilford. (Wilf.)
.\" Copyright (C) 2001-2019 Colin Watson.
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file docs/COPYING.GPLv2 that comes with the
.\" man-db distribution.
.\"
.\" Sat Oct 29 13:09:31 GMT 1994  Wilf. (G.Wilford@ee.surrey.ac.uk)
.\"
.pc ""
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH MANPATH 5 2025-05-02 2.13.1 /etc/man_db.conf
.SH NOME
manpath \- formato do ficheiro /etc/man_db.conf
.SH 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 $\fBMANPATH\fP já estiver definida, a informação
contida em /etc/man_db.conf não se lhe sobrepõe.
.SH "CAMINHO DE PROCURA"
Por pré\-definição, o man\-db examina a $\fBPATH\fP do utilizador. Para cada
elemento \fIpath_element\fP ali encontrado, adiciona \fImanpath_element\fP ao
caminho de procura.

Se não houver uma lnha \fBMANPATH_MAP\fP no ficheiro de configuração para um
dado \fIpath_element\fP, adiciona todos os \fIpath_element/../man\fP,
\fIpath_element/man\fP, \fIpath_element/../share/man\fP, e
\fIpath_element/share/man\fP que existam como pastas do caminho de procura.

Depois, adiciona qualquer entrada \fBMANDATORY_MANPATH\fP do ficheiro de
configuração ao caminho de procura.

Finalmente, se a opção \fB\-\-systems\fP for usada, ou a variável de ambiente
$\fBSYSTEM\fP estiver definida, tal deverá consistir numa sequência de nomes de
sistemas operativos, separados por vírgulas ou dois pontos. Isto age como
modelo, expandindo o caminho de procura mais uma vez para permitir acesso a
páginas de manual de outros sistemas operativos: para cada nome de sistema,
o man\-db procura esse nome como sub\-pasta de cada entrada no caminho de
procura, e adiciona\-a ao caminho de procura final, se existir. Um nome de
sistema de \fBman\fP insere o caminho de procura normal sem sub\-pastas. Por
exemplo, se o caminho de procura tivesse sido
\fI/usr/share/man:/usr/local/man\fP, e $\fBSYSTEM\fP estiver definida como
\fInewOS:man\fP, o caminho de procura final será
\fI/usr/share/man/newOS:\:/usr/share/man:\:/usr/local/man/newOS:\:/usr/local/man\fP.

A variável de ambiente $\fBMANPATH\fP subsitui os caminhos de procura
pré\-definidos para páginas do manual do man\-db. A maioria dos utilizadores
não terá de a definir. A sua sintaxe é similar à variável de ambiente
$\fBPATH\fP : consiste numa sequência de nomes de pastas separados por dois
pontos. Substitui o caminho de procura pré\-definido descrito acima.

Se o valor de $\fBMANPATH\fP começar com dois pontos, o caminho pré\-definido de
procura é adicionado ao seu início. Se o valor de $\fBMANPATH\fP terminar com
dois pontos, o caminho de procura pré\-definido é adicionado ao seu final. Se
o valor de $\fBMANPATH\fP contiver duplos dois pontos (\fB::\fP), o caminho de
procura pré\-definido é inserido no meio do valor, entre os duplos dois
pontos.
.SH FORMATO
Actualmente são reconhecidos os seguintes tipos:
.TP 
\fB#\fP\fI\ comentário\fP
Linhas em branco ou começadas com \fB#\fP serão tratadas como comentários e
ignoradas.
.TP 
\fBMANDATORY_MANPATH\fP\fI\ manpath_element\fP
Linhas desta forma indicam manpaths que todo o $\fBMANPATH\fP gerado
automaticamente deve conter. Isto incluirá tipicamente \fI/usr/man\fP.
.TP 
\fBMANPATH_MAP\fP\fI\ path_element\ manpath_element\fP
Linhas desta forma configuram $\fBPATH\fP para mapas $\fBMANPATH\fP. Para cada
\fIpath_element\fP encontrado no $\fBPATH\fP do utilizador, será adicionado
\fImanpath_element\fP a $\fBMANPATH\fP.
.TP 
\fBMANDB_MAP \fP\fImanpath_element \fP\|[\| \fIcatpath_element\fP \|]
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 \fBman\fP for um
programa setuid, porque (quando no ficheiro de configuração do sistema
/etc/man_db.conf  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 \fI/usr\fP, tal como \fI/usr/man\fP, \fI/usr/local/man\fP e
\fI/usr/X11R6/man\fP.

Se as páginas cat de um \fImanpath_element\fP não devem ser armazenadas ou
devem ser armazenadas na localização tradicional, \fIcatpath_element\fP 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 \fBLinux FSSTND\fP, a palavra\-chave \fBFSSTND\fP pode ser usada em
vez da pasta real.

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

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 \fI/usr/man/de_DE.88591\fP tem de vir
antes de \fI/usr/man\fP.
.TP 
\fBDEFINE\fP\fI\ valor\ de\ chave\fP
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 \fIgrep\fP e \fItbl\fP) e vários conjuntos predefinidos
de argumentos para esses programas.
.TP 
\fBSECTION\fP \fIsecção\fP .\|.\|.
.RS
Linhas desta forma definem a ordem em que as secções do manual devem ser
procuradas. Se não houver directivas \fBSECTION\fP no ficheiro de configuração,
a predefinição é:
.PP
.RS
.nf
.if  !'po4a'hide' SECTION 1 n l 8 3 0 2 3type 5 4 9 6 7
.fi
.RE
.PP
Se forem indicadas múltiplas directivas \fBSECTION\fP, as suas listas de
secções serão concatenadas.
.PP
Se uma extensão em particular nã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 ...").
.PP
\fBSECTIONS\fP é aceite como nome alternativo para esta directiva.
.RE
.TP 
\fBMINCATWIDTH\fP\fI\ largura\fP
Se a largura do terminal for menor que \fIlargura\fP, as páginas cat não serão
criadas (se em falta) ou mostradas. A predefinição é 80.
.TP 
\fBMAXCATWIDTH\fP\fI\ largura\fP
Se a largura do terminal for maior que \fIlargura\fP, as páginas cat não serão
criadas (se em falta) ou mostradas. A predefinição é 80.
.TP 
\fBCATWIDTH\fP\fI\ largura\fP
Se \fIwidth\fP for não\-zero, as páginas cat serão sempre formatadas para um
terminal da largura indicada, independentemente da largura do terminal
actualmente em uso. Isto substitui \fBMINCATWIDTH\fP e \fBMAXCATWIDTH\fP.
.TP 
.if  !'po4a'hide' .B NOCACHE
Esta bandeira impede que \fBman\fP(1) crie páginas cat automaticamente.
.SH 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.
.PP
.if  !'po4a'hide' https://gitlab.com/man-db/man-db/\-/issues
.br
.if  !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man\-db