Se a variável de ambiente $MANPATH já estiver definida, a informação contida em /etc/manpath.config não se lhe sobrepõe.
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.
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.
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.
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db