.\" 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 \- formata o arquivo /etc/man_db.conf
.SH 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 $\fBMANPATH\fP já estiver definida, as informações
contidas em /etc/man_db.conf não a sobrescreverão.
.SH "CAMINHO DE PESQUISA"
Por padrão, o man\-db examina o $\fBPATH\fP do usuário. Para cada
\fIpath_element\fP encontrado, ele adiciona \fImanpath_element\fP ao caminho de
pesquisa.

Se não houver nenhuma linha \fBMANPATH_MAP\fP no arquivo de configuração para
um determinado \fIpath_element\fP, ele adicionará todos os
\fIpath_element/../man\fP, \fIpath_element/man\fP, \fIpath_element/../share/man\fP e
\fIpath_element/share/man\fP que existem como diretórios ao caminho de
pesquisa.

Em seguida, ele adiciona quaisquer entradas \fBMANDATORY_MANPATH\fP do arquivo
de configuração ao caminho de pesquisa.

Por fim, se a opção \fB\-\-systems\fP for usada ou a variável de ambiente
$\fBSYSTEM\fP for definida, isso deverá consistir em uma sequência de nomes de
sistemas operacionais separados por vírgulas ou dois pontos. Isso funciona
como um modelo, expandindo o caminho de pesquisa mais uma vez para permitir
o acesso às páginas de manual de outros sistemas operacionais: para cada
nome de sistema, man\-db procura esse nome como um subdiretório de cada
entrada no caminho de busca e o adiciona ao caminho de pesquisa final, se
existir. Um nome de sistema \fBman\fP insere o caminho de pesquisa normal sem
subdiretórios. Por exemplo, se o caminho de pesquisa fosse
\fI/usr/share/man:/usr/local/man\fP e $\fBSYSTEM\fP estiver definido como
\fInewOS:man\fP, o caminho de busca final seria
\fI/usr/share/man/newOS:\:/usr/share/man:\:/usr/local/man/newOS:\:/usr/local/man\fP.

A variável de ambiente $\fBMANPATH\fP substitui os caminhos de pesquisa padrão
das páginas de manual do man\-db. A maioria dos usuários não precisa
defini\-la. Sua sintaxe é semelhante à da variável de ambiente $\fBPATH\fP:
consiste em uma sequência de nomes de diretórios separados por dois
pontos. Ela substitui o caminho de pesquisa padrão descrito acima.

Se $\fBMANPATH\fP estiver definido, \fBmanpath\fP exibe seu valor em vez de
determiná\-lo dinamicamente. Se $\fBMANPATH\fP for prefixado por um caractere de
dois pontos, então o valor de variável é anexado à lista determinada a
partir do conteúdo dos arquivos de configuração. Se o caractere de dois
pontos vem ao final do valor na variável, então a lista determinada é
anexada ao conteúdo da variável. Se o valor da variável contiver dupla de
caractere de dois pontos (\fB::\fP), então a lista determinada é inserida no
meio do valor, entre dois caracteres de dois pontos.
.SH FORMATO
Os seguintes tipos de campos são atualmente reconhecidos:
.TP 
\fB#\fP\fI\ comentário\fP
Linhas em branco ou aquelas iniciando com uma cerquilha (\fB#\fP) serão
tratadas como comentários ou ignoradas.
.TP 
\fBMANDATORY_MANPATH\fP\fI\ manpath_element\fP
Linhas nesta forma indicam caminhos man que toda $\fBMANPATH\fP gerada
automaticamente deve conter. Isso geralmente incluirá \fI/usr/man\fP.
.TP 
\fBMANPATH_MAP\fP\fI\ path_element\ manpath_element\fP
Linhas nesta forma configuram mapeamentos de $\fBPATH\fP para $\fBMANPATH\fP. Para
cada \fIpath_element\fP localizado no $\fBPATH\fP do usuários, \fImanpath_element\fP
será adicionado ao $\fBMANPATH\fP.
.TP 
\fBMANDB_MAP \fP\fImanpath_element \fP\|[\| \fIcatpath_element\fP \|]
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 \fBman\fP é um
programa setuid, como (quando no arquivo de configuração de sistema
/etc/man_db.conf 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 \fI/usr\fP tal como \fI/usr/man\fP, \fI/usr/local/man\fP e
\fI/usr/X11R6/man\fP.

Se páginas cat de um \fImanpath_element\fP em particular não devem ser
armazenadas ou devem ser armazenadas na localização traducional,
\fIcatpath_element\fP 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 \fBLinux FSSTND\fP, a palavra\-chave \fBFSSTND\fP pode
ser usada no lugar de um diretório real.

Infelizmente, é necessário especificar \fBtodos\fP os caminhos de árvore man do
sistema, incluindo caminhos alternativos do sistema operacional, tais como
\fI/usr/man/sun\fP e quaisquer caminhos \fBlocalidade NLS\fP tais como
\fI/usr/man/de_DE.88591\fP.

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 \fI/usr/man/de_DE.88591\fP deve vir antes de \fI/usr/man\fP.
.TP 
\fBDEFINE\fP\fI\ valor\ da\ chave\fP
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 \fIgrep\fP e \fItbl\fP) e conjuntos padrões de
argumentos daqueles programas.
.TP 
\fBSECTION\fP \fIseção\fP .\|.\|.
.RS
Linhas nesta forma definem a ordem na qual seções de manual devem ser
pesquisadas. Caso não há diretivas \fBSECTION\fP no arquivo de configuração, o
padrã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 múltiplas diretivas \fBSECTION\fP forem fornecidas, suas listas de seções
serão concatenadas.
.PP
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 ...").
.PP
\fBSECTIONS\fP é aceito como um nome alternativo para essa diretiva.
.RE
.TP 
\fBMINCATWIDTH\fP\fI\ largura\fP
Se a largura do terminal é menor que \fIlargura\fP, páginas cat não serão
criadas (se estiverem faltando) ou exibidas. O padrão é 80.
.TP 
\fBMAXCATWIDTH\fP\fI\ largura\fP
Se a largura do terminal é maior que \fIlargura\fP, páginas cat não serão
criadas (se estiverem faltando) ou exibidas. O padrão é 80.
.TP 
\fBCATWIDTH\fP\fI\ largura\fP
Se \fIlargura\fP é diferente de zero, páginas cat sempre serão formatadas para
um terminal da largura fornecida, independente da largura usada para o
terminal. Isso substitui \fBMINCATWIDTH\fP e \fBMAXCATWIDTH\fP.
.TP 
.if  !'po4a'hide' .B NOCACHE
Essa opção evita que \fBman\fP(1) crie páginas cat automaticamente.
.SH 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.
.PP
.if  !'po4a'hide' https://gitlab.com/man-db/man-db/\-/issues
.br
.if  !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man\-db