NUME
manpath - formatul fișierului /etc/manpath.configDESCRIERE
Fișierul de configurare al căii de manual(manpath) este utilizat de utilitarele paginilor de manual pentru a evalua căile de manual ale utilizatorilor în timpul executării, pentru a indica ce ierarhii a paginilor de manual(manpaths) vor fi tratate ca ierarhii de sistem și pentru a le atribui directoare pentru a fi utilizate pentru stocarea fișierelor «cat».CALEA DE CĂUTARE
În mod implicit, man-db examinează variabila de mediu $ PATH a utilizatorului. Pentru fiecare element_cale(path_element) găsit acolo, acesta adaugă element_cale_manual(manpath_element) la calea de căutare.FORMAT
Următoarele tipuri de câmpuri sunt în prezent recunoscute:- # comentariu
- Liniile goale sau cele care încep cu # vor fi tratate drept comentarii și vor fi ignorate.
- MANDATORY_MANPATH element_cale_manual(manpath_element)
- Liniile de această formă indică căile ierarhice de manual pe care ar trebui să le conțină fiecare $ MANPATH generat automat. Aceasta va include de obicei /usr/man.
- MANPATH_MAP element_cale(path_element) element_cale_manual(manpath_element)
- Liniile de această formă stabilesc asocieri între $ PATH și $MANPATH. Pentru fiecare element_cale găsit în variabila $ PATH a utilizatorului, va fi adăugat un element_cale_manual(manpath_element) la $ MANPATH.
- MANDB_MAP element_cale_manual(manpath_element) [ element_cale_cat(catpath_element) ]
- Liniile de această formă indică care căi de manual trebuie tratate precum căi de manual de sistem, și opțional unde ar trebui să fie stocate fișierele lor «cat». Acest tip de câmp este deosebit de important dacă man este un program setuid, deoarece (când se află în fișierul de configurare a sistemului /etc/manpath.config, mai degrabă decât în fișierul de configurare per utilizator .manpath), indică ce ierarhii de pagini de manual să acceseze ca utilizator setuid și care ca utilizator invocator. Ierarhiile de pagini de manual ale sistemului sunt de obicei cele stocate sub /usr precum /usr/man, /usr/local/man și /usr/X11R6/man. Dacă paginile «cat» dintr-un anumit element_cale_manual nu trebuie să fie stocate sau trebuie să fie stocate în locația tradițională, element(ul)_cale_cat poate fi omis. Amplasarea tradițională de «cat» ar fi imposibilă pentru ierarhiile de pagini de manual montate pentru numai- citire și din cauza asta este posibil să specificați orice ierarhie de director validă pentru stocarea acestora. Pentru a respecta Linux FSSTND(Sistemul de fișiere standard de Linux), cuvântul cheie FSSTND poate fi utilizat în locul unui director actual. Din păcate, este necesar să specificați toate căile de arbori de manual ale sistemului, inclusiv căile de sisteme de operare alternative precum /usr/man/sun și orice căi NLS locale, precum /usr/man/ro_RO.88592. NT: NLS = „Native Language Support” ⇛ Suport pentru limba nativă,maternă. Deoarece informațiile sunt analizate linie cu linie în ordinea scrisă, este necesar pentru orice cale de manual care este o sub-ierarhie a altei ierarhii să fie prima listată, în caz contrar va fi făcută o potrivire incorectă. Un exemplu este că /usr/man/ro_RO.88592 trebuie să apară înaintea lui /usr/man.
- DEFINE cheie valoare
- Liniile de această formă definesc variabilele de configurație diversă; vedeți fișierul de configurare implicit pentru acele variabile utilizate de utilitarele paginatorului de manual. Acestea includ căile implicite către diferite programe (precum grep și tbl), și seturile de argumente implicite pentru acele programe.
- SECTION secțiune ...
Liniile de această formă
definesc ordinea în care secțiunile de manual ar trebui
să fie căutate. Dacă nu există nicio
directivă SECTION în fișierul de configurare,
directiva implicită este:
Dacă sunt date multiple directive SECTION, listele lor de
secțiune vor fi concatenate.
Dacă o anumită extensie nu se află în această
listă (să zicem, 1 mh), aceasta va fi afișată
împreună cu restul secțiunii căreia îi
aparține. Efectul acestui lucru este, că trebuie să
enumerați în mod explicit extensiile, doar dacă
doriți să forțați o anumită ordine.
Secțiunile cu extensii ar trebui să fie de obicei adiacente
secțiunii lor principale (de exemplu, „1 1mh 8 ...”).
SECTIONS este acceptat ca un nume alternativ pentru această
directivă.
SECTION 1 n l 8 3 0 2 3type 5 4 9 6 7
- MINCATWIDTH lățime
- Dacă lățimea terminalului este mai mică decât lățimea, paginile «cat» nu vor fi create (dacă lipsesc) sau afișate. Lățimea implicită este 80.
- MAXCATWIDTH lățime
- Dacă lățimea terminalului este mai mare decât lățime, paginile «cat» nu vor fi create (dacă lipsesc) sau afișate. Lățimea implicită este 80.
- CATWIDTH lățime
- Dacă lățimea este diferită de zero, paginile «cat» vor fi întotdeauna formatate pentru un terminal cu lățimea dată, indiferent de lățimea terminalului utilizat efectiv. Acest lucru suprascrie intervalul stabilit de MINCATWIDTH și MAXCATWIDTH.
- NOCACHE
- Această opțiune evită ca man(1) să creeze automat pagini «cat».
DEFECȚIUNI
Dacă regulile de mai sus nu sunt urmate și respectate cu precizie, utilitarele paginatorului de manual nu vor funcționa așa cum este dorit. Regulile sunt extraordinar de complicate 👿. https://gitlab.com/man-db/man-db/-/issues| 2023-01-08 | 2.11.2 |