MANPATH(5) /etc/man_db.conf MANPATH(5) NOME manpath - formato do ficheiro /etc/man_db.conf DESCRICAO O ficheiro de configuracao de manpath e usado pelos utilitarios das paginas do manual para avaliar os manpath do utilizador em tempo de execucao, para indicar quais as hierarquias de paginas do manual (manpaths) devem ser tratadas como hierarquias do sistema e como atribuir-lhes pastas a usar para armazenar ficheiros cat. Se a variavel de ambiente $MANPATH ja estiver definida, a informacao contida em /etc/man_db.conf nao se lhe sobrepoe. 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 sao reconhecidos os seguintes tipos: # comentario Linhas em branco ou comecadas com # serao tratadas como comentarios e ignoradas. MANDATORY_MANPATH manpath_element Linhas desta forma indicam manpaths que todo o $MANPATH gerado automaticamente deve conter. Isto incluira 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, sera 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 e particularmente importante se man for um programa setuid, porque (quando no ficheiro de configuracao do sistema % manpath_config_file% em vez no ficheiro de configuracao .manpath por utilizador) indica quais hierarquias de paginas do manual aceder como utilizador setuid e quais aceder como o utilizador chamador. As hierarquias das paginas de manual do sistema estao habitualmente armazenadas em /usr, tal como /usr/man, /usr/local/man e /usr/X11R6/man. Se as paginas cat de um manpath_element nao devem ser armazenadas ou devem ser armazenadas na localizacao tradicional, catpath_element pode ser omitido. A colocacao tradicional de cat seria impossivel para hierarquias de paginas do manual montadas como so de leitura e, por causa disto, e possivel especificar qualquer hierarquia valida para o seu armazenamento. Para observacao de Linux FSSTND, a palavra-chave FSSTND pode ser usada em vez da pasta real. Infelizmente, e necessario especificar todos os caminhos de sistema de arvores 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 informacao e analisada linha a linha na ordem de escrita, e necessario que qualquer manpath que seja uma sub-hierarquia de outra hierarquia seja listado primeiro, senao sera feita uma correspondencia 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 variaveis de configuracao; veja o ficheiro de configuracao predefinido para consultar as variaveis usadas pelos utilitarios das paginas do manual. Incluem caminhos predefinidos para varios programas (tais co grep e tbl) e varios conjuntos predefinidos de argumentos para esses programas. SECTION seccao ... Linhas desta forma definem a ordem em que as seccoes do manual devem ser procuradas. Se nao houver directivas SECTION no ficheiro de configuracao, a predefinicao e: SECTION 1 n l 8 3 0 2 3type 5 4 9 6 7 Se forem indicadas multiplas directivas SECTION, as suas listas de seccoes serao concatenadas. Se uma extensao em particularnao estiver na lista (digamos, 1mh), sera mostrada com o resto da seccao a que pertence. O efeito disto e que so precisa de listar explicitamente extensoes se pretender forcar uma determinada ordem. Seccoes com extensoes devem habitualmente ser adjacentes a sua seccao principal (e.g. "1 1mh 8 ..."). SECTIONS e aceite como nome alternativo para esta directiva. MINCATWIDTH largura Se a largura do terminal for menor que largura, as paginas cat nao serao criadas (se em falta) ou mostradas. A predefinicao e 80. MAXCATWIDTH largura Se a largura do terminal for maior que largura, as paginas cat nao serao criadas (se em falta) ou mostradas. A predefinicao 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 Esta bandeira impede que man(1) crie paginas cat automaticamente. ERROS A nao ser que as regras acima sejam rigorosamente seguidas e observadas, os utilitarios das paginas do manual nao funcionarao como desejavel. 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)