LEXGROG(1)           Utilitare ale paginatorului de manual          LEXGROG(1)

NUME
       lexgrog - analizeaza 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 in lex.
       Acesta cite<?>te lista de fi<?>iere din linia de comanda fie ca
       fi<?>iere sursa a paginilor de manual, fie ca pagini preformatate
       \(lqcat\(rq, <?>i afi<?>eaza numele <?>i descrierea acestora a<?>a cum
       sunt utilizate de apropos <?>i whatis, afi<?>eaza lista filtrelor de
       preprocesare necesare paginii de manual inainte de a fi transmisa la
       nroff sau troff sau ambele.

       Daca intrarea aceasta este formatata gre<?>it, lexgrog va imprima
       "parse failed"; acest lucru poate fi util pentru programele externe
       care trebuie sa verifice paginile de manual pentru corectitudine.  Daca
       unul dintre fi<?>ierele de intrare ale lui lexgrog este "-", se va citi
       de la intrarea standard; daca orice fi<?>ier de intrare este comprimat,
       o versiune descomprimata va fi citita automat.

OP<?>IUNI
       -d, --debug
              Imprima informa<?>iile de depanare.

       -m, --man
              Analizeaza intrarea ca fi<?>iere sursa de pagini de manual.
              Acesta este comportamentul implicit daca nu este dat nici --man,
              nici --cat.

       -c, --cat
              Analizeaza intrarea ca pagini de manual preformatate ("cat
              pages"). --man <?>i --cat nu pot fi date simultan.

       -w, --whatis
              Afi<?>eaza numele <?>i descrierea din antetul paginii de manual,
              a<?>a cum sunt utilizate de apropos <?>i whatis. Aceasta este
              comportamentul implicit daca nu este specificat nici --whatis,
              nici --filters.

       -f, --filters
              Afi<?>eaza lista de filtre necesare pentru a preprocesa pagina
              de manual, inainte de a fi formatata cu nroff sau troff.

       -E codificarea, --encoding codificarea
              Suprascrie setul de caractere ghicit pentru pagina, cu
              codificarea.

       -?, --help
              Imprima un mesaj de ajutor <?>i iese.

       --usage
              Imprima un mesaj scurt de utilizare <?>i iese.

       -V, --version
              Afi<?>eaza informa<?>ii despre versiune.

STARE DE IE<?>IRE
       0      Executarea programului s-a incheiat fara erori.

       1      Eroare de utilizare.

       2      lexgrog nu a reu<?>it sa analizeze unul sau mai multe dintre
              fi<?>ierele de intrare.

EXEMPLE
         $ lexgrog man.1
         man.1: "man - o interfa<?>a la manualele de referin<?>a ale sistemului"
         $ lexgrog -fw man.1
         man.1 (t): "man - o interfa<?>a la manualele de referin<?>a ale sistemului"
         $ lexgrog -c whatis.cat1
         whatis.cat1: "whatis - afi<?>eaza descrieri ale paginilor de manual"
         $ lexgrog defect.1
         broken.1: analizarea a e<?>uat

ANALIZARE WHATIS
       mandb (care utilizeaza acela<?>i cod ca lexgrog)  analizeaza
       sec<?>iunea NUME din partea de sus a fiecarei pagini de manual, cautand
       nume <?>i descrieri ale caracteristicilor documentate in fiecare dintre
       ele.  Cu toate ca analizatorul este destul de tolerant, deoarece
       trebuie sa faca fa<?>a unui numar de forme diferite care au fost
       folosite in trecut, acesta poate cateodata sa e<?>ueze in extragerea
       informa<?>iilor necesare.

       Cand se utilizeaza setul de macrocomenzi tradi<?>ional man, o
       sec<?>iune corecta NUME arata cam a<?>a:

              .SH NUME
              foo \- program ce face ceva

       Unele paginatoare de manual necesita ca `\-' sa fie exact a<?>a cum
       este aratat(aici); mandb este mai tolerant, dar pentru compatibilitate
       cu alte sisteme este totu<?>i o idee buna sa pastra<?>i bara oblica
       inversa.

       In partea din stanga, pot sa fie mai multe nume, separate prin virgula.
       Numele care con<?>in spa<?>ii, vor fi ignorate pentru a se evita un
       comportament neobi<?>nuit in anumite sec<?>iuni NUME formatate
       gre<?>it.  Textul din partea dreapta este in forma libera, <?>i se
       poate fi intinde pe mai multe randuri.  Daca mai multe
       func<?>ionalita<?>i cu descrieri diferite sunt documentate in aceea<?>i
       pagina de manual, va fi utilizat urmatorul format:

              .SH NUME
              foo, bar \- programe ce fac ceva
              .br
              baz \- program ce nu face nimic

       (O macrocomanda care incepe un nou paragraf, cum ar fi .PP, poate fi
       utilizata in locul macrocomenzii de intrerupere de linie .br.)

       Cand se utilizeaza setul de macrocomenzi mdoc derivat din BSD, o
       sec<?>iune NUME corecta, arata cam a<?>a:

              .Sh NUME
              .Nm foo
              .Nd program ce face ceva

       Exista mai multe motive comune pentru care analizarea <<whatis
       >>e<?>ueaza.  Uneori autorii paginilor de manual inlocuiesc `.SH NUME'
       cu `.SH PROGRAMULMEU' <?>i apoi mandb nu poate gasi sec<?>iunea de la
       care sa extraga informa<?>iile de care are nevoie.  Uneori autorii
       includ o sec<?>iune NUME, dar plaseaza text in forma libera acolo, in
       locul `nume \- descriere'.  Totu<?>i, orice sintaxa care se aseamana cu
       cea de deasupra ar trebui sa fie acceptata.

CONSULTA<?>I <?>I
       apropos(1), man(1), whatis(1), mandb(8)

NOTE
       lexgrog incearca sa analizeze fi<?>ierele care con<?>in solicitari .so,
       dar va putea face acest lucru corect numai daca fi<?>ierele sunt
       instalate a<?>a cum trebuie intr-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 curenta a interfe<?>ei liniei de
       comanda, precum <?>i aceasta pagina de manual.

DEFEC<?>IUNI
       https://gitlab.com/man-db/man-db/-/issues
       https://savannah.nongnu.org/bugs/?group=man-db

2.12.1                            2024-04-05                        LEXGROG(1)