MANPATH(5) /etc/man_db.conf MANPATH(5) NOME manpath - formata o arquivo /etc/man_db.conf DESCRICAO O arquivo de configuracao do manpath e usado pelos utilitarios de pagina de manual para avaliar os caminhos man dos usuarios em tempo de execucao, para indicar quais hierarquias de pagina de manual (caminhos man) devem ser tratadas como hierarquias do sistema e para atribui-las a diretorios para ser usados para armazenar arquivos cat. Se a variavel de ambiente $MANPATH ja estiver definida, as informacoes contidas em /etc/man_db.conf nao a sobrescreverao. 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 sao atualmente reconhecidos: # comentario Linhas em branco ou aquelas iniciando com uma cerquilha (#) serao tratadas como comentarios ou ignoradas. MANDATORY_MANPATH manpath_element Linhas nesta forma indicam caminhos man que toda $MANPATH gerada automaticamente deve conter. Isso geralmente incluira /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 usuarios, manpath_element sera 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 e particularmente importante se man e um programa setuid, como (quando no arquivo de configuracao de sistema /etc/man_db.conf em vez do arquivo de configuracao per-usuario .manpath) ele indica quais hierarquias de pagina de manual devem ser acessadas como o usuario setuid e qual como usuario invocador. As hierarquias de pagina de manual do sistema geralmente sao aquelas armazenadas sob /usr tal como /usr/man, /usr/local/man e /usr/X11R6/man. Se paginas cat de um manpath_element em particular nao devem ser armazenadas ou devem ser armazenadas na localizacao traducional, catpath_element pode ser omitido. Colocacao de cat tradicional seria impossivel para hierarquias de paginas de manual montadas como somente leituras e, por causa disso, e possivel especificar qualquer hierarquia valida de diretorios para seu armazenamento. Para observar Linux FSSTND, a palavra-chave FSSTND pode ser usada no lugar de um diretorio real. Infelizmente, e necessario especificar todos os caminhos de arvore 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 informacao e analisada linha por linha na ordem escrita, e necessario para qualquer caminho man que e um subdiretorio de uma outra hierarquia ser listado primeiro, do contrario uma correspondencia incorreta sera feita. Uma exemplo disso e que /usr/man/de_DE.88591 deve vir antes de /usr/man. DEFINE valor da chave Linhas nesta forma definem diversas variaveis de configuracao; veja o arquivo de configuracao padrao para aquelas variaveis usadas pelos utilitarios paginacao de manual. Eles incluem caminhos de padrao para programas variados (tais como grep e tbl) e conjuntos padroes de argumentos daqueles programas. SECTION secao ... Linhas nesta forma definem a ordem na qual secoes de manual devem ser pesquisadas. Caso nao ha diretivas SECTION no arquivo de configuracao, o padrao e: SECTION 1 n l 8 3 0 2 3type 5 4 9 6 7 Se multiplas diretivas SECTION forem fornecidas, suas listas de secoes serao concatenadas. Se uma extensao em particular nao estiver nessa lista (digamos, 1mh), ela sera exibida com o resto da secao a qual ela pertence. O efeito disso e que voce apenas precisa listar explicitamente extensoes se voce deseja forcar uma ordem em particular. As secoes com extensoes geralmente devem ser adjacente as suas secoes principais (ex.: "1 1mh 8 ..."). SECTIONS e aceito como um nome alternativo para essa diretiva. MINCATWIDTH largura Se a largura do terminal e menor que largura, paginas cat nao serao criadas (se estiverem faltando) ou exibidas. O padrao e 80. MAXCATWIDTH largura Se a largura do terminal e maior que largura, paginas cat nao serao criadas (se estiverem faltando) ou exibidas. O padrao e 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 Essa opcao evita que man(1) crie paginas cat automaticamente. PROBLEMAS A menos que as regras acima sejam seguidas e observadas com muita atencao, os utilitarios de paginacao de manual nao funcionarao como desejado. As regras sao excessivamente complicadas. https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db 2.12.1 2024-04-05 MANPATH(5)