Scroll to navigation

MANPATH(5) /etc/manpath.config MANPATH(5)

NUME

manpath - formatează fișierul /etc/manpath.config

DESCRIERE

Fișierul de configurare a căii de manual este utilizat de utilitățile paginilor de manual pentru a evalua căile man ale utilizatorului la executare, pentru a indica care dintre ierarhiile paginilor de manual (căilor de man) vor fi tratate ca ierarhii de sistem și pentru a le atribui directoare să fie utilizate pentru stocarea fișierelor cat.

Dacă variabila de mediu $MANPATH este stabilită deja, informațiile conținute în /etc/manpath.config nu o va suprascrie.

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.

FORMAT

Următoarele tipuri de câmp sunt recunoscute curent:

# comentariu
Liniile goale sau cele care încep cu un # vor fi tratate ca și comentarii și vor fi ignorate.
Liniile de această formă indică căile man care fiecare $MANPATH generat automat ar trebui să conțină. Acest lucru va include tipic /usr/man.
Liniile de această formă stabilesc $PATH la mapări $MANPATH. Pentru fiecare path_element găsit în $PATH utilizatorului, manpath_element va fi adăugat la $MANPATH.
Liniile de această formă indică care căi de manual se vor trata precum căi de manual de sistem, și opțional unde ar trebui să fie stocate fișierele cat. Acest tip de câmp este în mod particular important dacă man este un program setuid, pentru că (când în fișierul de configurare a sistemului /etc/manpath.config decât la fișierul de configurare per-utilizator .manpath) acesta indică care ierarhii de pagini de manual să se acceseze ca utilizatorul setuid și care să se acceseze ca utilizatorul invocat.

Ierarhiile de pagini de manual ale sistemului sunt de obicei acele stocate sub /usr precum /usr/man, /usr/local/man și /usr/X11R6/man.

Dacă paginile cat de la un manpath_element particular nu vor fi stocate sau sunt pe cale să fie stocate în locația tradițională, catpath_element poate fi omis.

Plasarea cat tradițională ar fi imposibilă pentru ierarhiile de pagini de manual montate în doar citire și din cauza asta este posibil să specificați orice ierarhie de director validă pentru stocarea acestora. Pentru a observa Linux FSSTND cuvântul cheie FSSTND poate fi utilizat în locul unui director actual.

Din păcate, este necesar să specificați all căile de arbore de man ale sistemului, inclusiv căile de sistem de operare alternative precum căile /usr/man/sun și orice căi NLS locale precum /usr/man/de_DE.88591.

Deoarece informațiile sunt analizate linie cu linie în ordinea scrisă, este necesar pentru orice cale de man care este o sub-ierarhie a altei ierarhii să fie listată mai întâi, în caz contrar o potrivire incorectă va fi făcută. Un exemplu este că /usr/man/de_DE.88591 trebuie să vină înaintea lui /usr/man.

Liniile de această formă definesc variabilele de configurație diversă; vedeți fișierul de configurație implicit pentru acele variabile utilizate de utilitățile pagerului de manual. Acestea includ căile către programele variate (precum grep și tbl), și seturile implicite de argumente la acele programe.
Liniile de această formă definesc ordinea în care secțiunile de manual ar trebui să fie căutate. Dacă nu există directive SECTION în fișierul de configurare, implicitul este: 

SECTION 1 n l 8 3 0 2 5 4 9 6 7

Dacă sunt date directive multiple SECTION, listele lor de secțiune vor fi concatenate.

Dacă o extensie particulară nu este în această listă (să spunem, 1mh) aceasta va fi afișată cu restul secțiunii de care aparține. Efectul acestui lucru este că aveți nevoie să listați explicit extensii dacă doriți să forțați o ordine particulară. Secțiunile cu extensii ar trebui de obicei să fie adiacente secțiunilor principale (de ex. „1 1mh 8 ...”).

SECTIONS este acceptat ca un nume alternativ pentru această directivă.

Dacă lățimea terminalului este mai mică decât width, paginile cat nu vor fi create (dacă lipsesc) sau afișate. Implicitul este 80.
Dacă lățimea terminalului este mai mare decât width, paginile cat nu vor fi create (dacă lipsesc) sau afișate. Implicitul este 80.
Dacă width nu este zero, paginile cat vor fi întotdeauna formatate pentru un terminal de lățimea dată, indiferent de lățimea terminalului actual utilizată. Acest lucru ar trebui în general să fie în intervalul stabilit de MINCATWIDTH și MAXCATWIDTH.
Acest fanion previne man(1) din a cea pagini cat automat.

DEFECȚIUNI

Dacă regulile de mai sus nu sunt urmate și observate precis, utilitățile pagerului de manual nu vor funcționa așa cum este dorit. Regulile sunt prea complicate.

https://gitlab.com/cjwatson/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db

2022-02-10 2.10.1