MANPATH(5)                     /etc/man_db.conf                     MANPATH(5)

NUME
       manpath - formatul fi<?>ierului /etc/man_db.conf

DESCRIERE
       Fi<?>ierul de configurare al rutei de manual(manpath) este utilizat de
       utilitarele paginilor de manual pentru a evalua rutele de manual ale
       utilizatorilor in timpul executarii, 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>>.

       Daca variabila de mediu $MANPATH este deja stabilita, informa<?>iile
       con<?>inute in /etc/man_db.conf nu o vor suprascrie.

RUTA DE CAUTARE
       In mod implicit, man-db examineaza variabila de mediu $PATH a
       utilizatorului.  Pentru fiecare element_ruta(path_element) gasit acolo,
       acesta adauga element_ruta_manual(manpath_element) la ruta de cautare.

       Daca nu exista o linie MANPATH_MAP in fi<?>ierul de configurare pentru
       un anumit element_ruta, atunci se adauga toate element_ruta/../man,
       element_ruta/man, element_ruta/../ share/man <?>i
       element_ruta/share/man care exista ca directoare la ruta de cautare.

       Apoi adauga orice intrari MANDATORY_MANPATH din fi<?>ierul de
       configurare la ruta de cautare.

       In cele din urma, daca este utilizata op<?>iunea --systems sau este
       stabilita variabila de mediu $SYSTEM, atunci aceasta ar trebui sa
       con<?>ina o secven<?>a de nume de sisteme de operare separate prin
       virgule sau doua puncte.  Aceasta ac<?>ioneaza ca un <?>ablon,
       extinzand ruta de cautare inca o data pentru a permite accesul la
       paginile de manual ale altor sisteme de operare: pentru fiecare nume de
       sistem, man-db cauta acel nume ca subdirector al fiecarei intrari din
       ruta de cautare <?>i il adauga la ruta finala de cautare, daca exista.
       Un nume de sistem man insereaza ruta normala de cautare fara
       subdirectoare.  De exemplu, daca ruta de cautare ar fi fost astfel:
       /usr/share/man:/usr/local/man, iar $SYSTEM este stabilita la nouSO:man,
       atunci ruta finala de cautare va fi:
       /usr/share/man/nouSO:/usr/share/man:/usr/local/man/nouSO:/usr/local/man.

       Variabila de mediu $MANPATH suprascrie rutele implicite de cautare a
       paginilor de manual ale man-db.  Majoritatea utilizatorilor nu ar
       trebui sa aiba nevoie sa o stabileasca.  Sintaxa sa este similara cu
       variabila de mediu $PATH: consta dintr-o secven<?>a de nume de
       directoare separate prin doua puncte.  Acesta suprascrie ruta de
       cautare implicita descrisa mai sus.

       Daca valoarea lui $MANPATH incepe cu doua puncte, atunci ruta implicita
       de cautare este adaugata la inceput.  Daca valoarea lui $MANPATH se
       termina cu doua puncte, atunci ruta implicita de cautare este adaugata
       la sfar<?>itul acesteia.  Daca valoarea lui $MANPATH con<?>ine doua
       puncte duble (::), atunci ruta implicita de cautare este inserata in
       mijlocul valorii, intre cele doua doua puncte.

FORMAT
       Urmatoarele tipuri de campuri sunt in prezent recunoscute:

       # comentariu
              Liniile goale sau cele care incep cu # vor fi tratate drept
              comentarii <?>i vor fi ignorate.

       MANDATORY_MANPATH element_ruta_manual(manpath_element)
              Liniile de aceasta forma indica rutele ierarhice de manual pe
              care ar trebui sa le con<?>ina fiecare $MANPATH generat automat.
              Aceasta va include de obicei /usr/man.

       MANPATH_MAP element_ruta(path_element) element_ruta_manual(manpath_element)
              Liniile de aceasta forma stabilesc asocieri intre $PATH <?>i
              $MANPATH.  Pentru fiecare element_ruta gasit in variabila $PATH
              a utilizatorului, va fi adaugat un
              element_ruta_manual(manpath_element) la $MANPATH.

       MANDB_MAP element_ruta_manual(manpath_element) [
       element_ruta_cat(catpath_element) ]
              Liniile de aceasta forma indica care rute de manual trebuie
              tratate precum rute de manual de sistem, <?>i op<?>ional unde ar
              trebui sa fie stocate fi<?>ierele lor <<cat>>.  Acest tip de
              camp este deosebit de important daca man este un program setuid,
              deoarece (cand se afla in fi<?>ierul de configurare a sistemului
              /etc/man_db.conf, mai degraba decat in fi<?>ierul de configurare
              per utilizator .manpath), indica ce ierarhii de pagini de manual
              sa 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.

              Daca paginile <<cat>> dintr-un anumit element_ruta_manual nu
              trebuie sa fie stocate sau trebuie sa fie stocate in loca<?>ia
              tradi<?>ionala, element(ul)_ruta_cat poate fi omis.

              Amplasarea tradi<?>ionala de <<cat>> ar fi imposibila pentru
              ierarhiile de pagini de manual montate pentru numai- citire <?>i
              din cauza asta este posibil sa specifica<?>i orice ierarhie de
              director valida pentru stocarea acestora.  Pentru a respecta
              Linux FSSTND(Sistemul de fi<?>iere standard de Linux), cuvantul
              cheie FSSTND poate fi utilizat in locul unui director actual.

              Din pacate, este necesar sa specifica<?>i toate rutele de arbori
              de manual ale sistemului, inclusiv rutele de sisteme de operare
              alternative precum /usr/man/sun <?>i orice rute NLS locale,
              precum /usr/man/ro_RO.88592. NT: NLS = ,,Native Language
              Support" <?> Suport pentru limba nativa,materna.

              Deoarece informa<?>iile sunt analizate linie cu linie in ordinea
              scrisa, este necesar pentru orice ruta de manual care este o
              sub-ierarhie a altei ierarhii sa fie prima listata, in caz
              contrar va fi facuta o potrivire incorecta.  Un exemplu este ca
              /usr/man/ro_RO.88592 trebuie sa apara inaintea lui /usr/man.

       DEFINE cheie valoare
              Liniile de aceasta forma definesc variabilele de configura<?>ie
              diversa; vede<?>i fi<?>ierul de configurare implicit pentru
              acele variabile utilizate de utilitarele paginatorului de
              manual.  Acestea includ rutele implicite catre diferite programe
              (precum grep <?>i tbl), <?>i seturile de argumente implicite
              pentru acele programe.

       SECTION sec<?>iune ...
              Liniile de aceasta forma definesc ordinea in care sec<?>iunile
              de manual ar trebui sa fie cautate.  Daca nu exista nicio
              directiva SECTION in fi<?>ierul de configurare, directiva
              implicita este:

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

              Daca sunt date multiple directive SECTION, listele lor de
              sec<?>iune vor fi concatenate.

              Daca o anumita extensie nu se afla in aceasta lista (sa zicem, 1
              mh), aceasta va fi afi<?>ata impreuna cu restul sec<?>iunii
              careia ii apar<?>ine.  Efectul acestui lucru este, ca trebuie sa
              enumera<?>i in mod explicit extensiile, doar daca dori<?>i sa
              for<?>a<?>i o anumita ordine.  Sec<?>iunile cu extensii ar
              trebui sa fie de obicei adiacente sec<?>iunii lor principale (de
              exemplu, ,,1 1mh 8 ...").

              SECTIONS este acceptat ca un nume alternativ pentru aceasta
              directiva.

       MINCATWIDTH la<?>ime
              Daca la<?>imea terminalului este mai mica decat la<?>imea,
              paginile <<cat>> nu vor fi create (daca lipsesc) sau afi<?>ate.
              La<?>imea implicita este 80.

       MAXCATWIDTH la<?>ime
              Daca la<?>imea terminalului este mai mare decat la<?>ime,
              paginile <<cat>> nu vor fi create (daca lipsesc) sau afi<?>ate.
              La<?>imea implicita este 80.

       CATWIDTH la<?>ime
              Daca la<?>imea este diferita de zero, paginile <<cat>> vor fi
              intotdeauna formatate pentru un terminal cu la<?>imea data,
              indiferent de la<?>imea terminalului utilizat efectiv.  Acest
              lucru suprascrie intervalul stabilit de MINCATWIDTH <?>i
              MAXCATWIDTH.

       NOCACHE
              Aceasta op<?>iune evita ca man(1)  sa creeze automat pagini
              <<cat>>.

DEFEC<?>IUNI
       Daca 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
       https://savannah.nongnu.org/bugs/?group=man-db

2.12.1                            2024-04-05                        MANPATH(5)