Provided by: man-db_2.11.2-3_amd64 
NUME
lexgrog - analizează informațiile antetului din paginile de manual
REZUMAT
lexgrog [-m|-c] [-dfw?V] [-E codificarea] fișier ...
DESCRIERE
lexgrog este o implementare a utilitarului tradițional “groff în lex. Acesta citește
lista de fișiere din linia de comandă fie ca fișiere sursă a paginilor de manual, fie ca
pagini preformatate \(lqcat\(rq, și afișează numele și descrierea acestora așa cum sunt
utilizate de apropos și whatis, afișează lista filtrelor de preprocesare necesare paginii
de manual înainte de a fi transmisă la nroff sau troff sau ambele.
Dacă intrarea aceasta este formatată greșit, lexgrog va imprima “parse failed”; acest
lucru poate fi util pentru programele externe care trebuie să verifice paginile de manual
pentru corectitudine. Dacă unul dintre fișierele de intrare ale lui lexgrog este “-”, se
va citi de la intrarea standard; dacă orice fișier de intrare este comprimat, o versiune
descomprimată va fi citită automat.
OPȚIUNI
-d, --debug
Imprimă informațiile de depanare.
-m, --man
Analizează intrarea ca fișiere sursă de pagini de manual. Acesta este
comportamentul implicit dacă nu este dat nici --man, nici --cat.
-c, --cat
Analizează intrarea ca pagini de manual preformatate (“cat pages”). --man și --cat
nu pot fi date simultan.
-w, --whatis
Afișează numele și descrierea din antetul paginii de manual, așa cum sunt utilizate
de apropos și whatis. Aceasta este comportamentul implicit dacă nu este specificat
nici --whatis, nici --filters.
-f, --filters
Afișează lista de filtre necesare pentru a preprocesa pagina de manual, înainte de
a fi formatată cu nroff sau troff.
-E codificarea, --encoding codificarea
Suprascrie setul de caractere ghicit pentru pagină, cu codificarea.
-?, --help
Imprimă un mesaj de ajutor și iese.
--usage
Imprimă un mesaj scurt de utilizare și iese.
-V, --version
Afișează informații despre versiune.
STARE DE IEȘIRE
0 Executarea programului s-a încheiat fără erori.
1 Eroare de utilizare.
2 lexgrog nu a reușit să analizeze unul sau mai multe dintre fișierele de intrare.
EXEMPLE
$ lexgrog man.1
man.1: "man - o interfață la manualele de referință ale sistemului"
$ lexgrog -fw man.1
man.1 (t): "man - o interfață la manualele de referință ale sistemului"
$ lexgrog -c whatis.cat1
whatis.cat1: "whatis - afișează descrieri ale paginilor de manual"
$ lexgrog defect.1
broken.1: analizarea a eșuat
ANALIZARE WHATIS
mandb (care utilizează același cod ca lexgrog) analizează secțiunea NUME din partea de
sus a fiecărei pagini de manual, căutând nume și descrieri ale caracteristicilor
documentate în fiecare dintre ele. Cu toate că analizatorul este destul de tolerant,
deoarece trebuie să facă față unui număr de forme diferite care au fost folosite în
trecut, acesta poate câteodată să eșueze în extragerea informațiilor necesare.
Când se utilizează setul de macrocomenzi tradițional man, o secțiune corectă NUME arată
cam așa:
.SH NUME foo \- program ce face ceva
Unele paginatoare de manual necesită ca ‘\-’ să fie exact așa cum este arătat(aici); mandb
este mai tolerant, dar pentru compatibilitate cu alte sisteme este totuși o idee bună să
păstrați bara oblică inversă.
În partea din stânga, pot să fie mai multe nume, separate prin virgulă. Numele care
conțin spații, vor fi ignorate pentru a se evita un comportament neobișnuit în anumite
secțiuni NUME formatate greșit. Textul din partea dreaptă este în formă liberă, și se
poate fi întinde pe mai multe rânduri. Dacă mai multe funcționalități cu descrieri
diferite sunt documentate în aceeași pagină de manual, va fi utilizat următorul format:
.SH NUME foo, bar \- programe ce fac ceva .br baz \- program ce nu face nimic
(O macrocomandă care începe un nou paragraf, cum ar fi .PP, poate fi utilizată în locul
macrocomenzii de întrerupere de linie .br.)
Când se utilizează setul de macrocomenzi mdoc derivat din BSD, o secțiune NUME corectă,
arată cam așa:
.Sh NUME .Nm foo .Nd program ce face ceva
Există mai multe motive comune pentru care analizarea «whatis »eșuează. Uneori autorii
paginilor de manual înlocuiesc ‘.SH NUME’ cu ‘.SH PROGRAMULMEU’ și apoi mandb nu poate
găsi secțiunea de la care să extragă informațiile de care are nevoie. Uneori autorii
includ o secțiune NUME, dar plasează text în formă liberă acolo, în locul ‘nume \-
descriere’. Totuși, orice sintaxă care se aseamănă cu cea de deasupra ar trebui să fie
acceptată.
CONSULTAȚI ȘI
apropos(1), man(1), whatis(1), mandb(8)
NOTE
lexgrog încearcă să analizeze fișierele care conțin solicitări .so, dar va putea face
acest lucru corect numai dacă fișierele sunt instalate așa cum trebuie într-o ierarhie de
pagini de manual.
AUTOR
Codul utilizat de lexgrog pentru a scana paginile de manual a fost scris de:
Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).
Colin Watson a scris versiunea curentă a interfeței liniei de comandă, precum și această
pagină de manual.
DEFECȚIUNI
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db