lexgrog - Online în cloud

PROGRAM:

NUME

lexgrog - analizează informațiile antetului din paginile de manual

REZUMAT

lexgrog [-m|-c] [-dfw?V] [-E codare] fişier ...

DESCRIERE

lexgrog este o implementare a utilitarului tradițional „groff guess” în Lex. Scrie
lista de fișiere de pe linia sa de comandă fie ca fișiere sursă a paginii de manual, fie preformatate
paginile „pisica” și le afișează numele și descrierea așa cum sunt utilizate de oportun și ce este,
lista de filtre de preprocesare cerute de pagina de manual înainte de a fi transmisă nroff or
troff, sau amândouă.

Dacă intrarea sa este prost formatată, lexgrog va tipări „parse failed”; acest lucru poate fi util pentru
programe externe care trebuie să verifice paginile de manual pentru corectitudine. Dacă unul dintre lexgrogintrarea lui
fișierele este „-”, se va citi din intrarea standard; dacă orice fișier de intrare este comprimat, a
versiunea decomprimată va fi citită automat.

OPŢIUNI

-d, --depanare
Tipăriți informațiile de depanare.

-m, --om
Analizați intrarea ca fișiere sursă a paginii de manual. Aceasta este valoarea implicită, dacă nici unul --om nici
--pisică este dată.

-c, --pisică
Analizați intrarea ca pagini de manual preformatate („pagini cat”). --om și --pisică S-ar putea să nu fie
dat simultan.

-w, --ce este
Afișează numele și descrierea din antetul paginii de manual, așa cum este folosit de oportun și
ce este. Aceasta este valoarea implicită, dacă nici unul --ce este nici --filtre este dată.

-f, --filtre
Afișați lista de filtre necesare pentru a preprocesa pagina de manual înainte de formatare
cu nroff or troff.

-E codare, --codare codare
Suprascrieți setul de caractere ghicit pentru pagină codare.

-?, --Ajutor
Imprimați un mesaj de ajutor și ieșiți.

--utilizare
Imprimați un mesaj scurt de utilizare și ieșiți.

-V, --versiune
Afișează informații despre versiune.

EXIT STAREA

0 Execuție cu succes a programului.

1 Eroare de utilizare.

2 lexgrog nu a reușit să analizeze unul sau mai multe dintre fișierele sale de intrare.

EXEMPLE

$ lexgrog man.1
man.1: „man - o interfață cu manualele de referință on-line”
$ lexgrog -fw man.1
man.1 (t): „man - o interfață cu manualele de referință on-line”
$ lexgrog -c whatis.cat1
whatis.cat1: „whatis - afișați descrierile paginilor manuale”
$ lexgrog spart.1
spart.1: analiza eşuată

CE ESTE ANALIZARE

mandb (care folosește același cod ca lexgrog) analizează NUME secțiune din partea de sus a fiecăruia
pagina de manual care caută nume și descrieri ale caracteristicilor documentate în fiecare. In timp ce
analizatorul este destul de tolerant, deoarece trebuie să facă față unui număr de forme diferite care au
folosit din punct de vedere istoric, uneori poate eșua în extragerea informațiilor necesare.

Când folosiți tradiționalul om set de macro, un corect NUME secțiunea arată ceva asemănător
acest:

.SH NUME
foo \- program pentru a face ceva

Unele pagere manuale necesită ca „\-” să fie exact așa cum se arată; mandb este mai tolerant, dar
pentru compatibilitate cu alte sisteme, este totuși o idee bună să păstrați
backslash.

În partea stângă, pot exista mai multe nume, separate prin virgulă. Nume care conțin
spațiile albe vor fi ignorate pentru a evita comportamentul patologic pe anumite prost formate NUME
secțiuni. Textul din partea dreaptă are formă liberă și poate fi întins pe mai multe
linii. Dacă mai multe caracteristici cu descrieri diferite sunt documentate în același
pagina de manual, se utilizează, prin urmare, următorul formular:

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

(O macrocomandă care începe un nou paragraf, cum ar fi .PP, poate fi utilizată în locul macrocomenzii de pauză
.br.)

Când utilizați derivatul BSD mdoc set de macro, un corect NUME secțiunea arată ceva asemănător
acest:

.Sh NUME
.Nm foo
.Nd program pentru a face ceva

Există mai multe motive comune pentru care analizarea whatis eșuează. Uneori autori de manual
paginile înlocuiesc „.SH NAME” cu „.SH MYPROGRAM”, apoi mandb nu pot găsi secțiunea din
de care să extragă informaţiile de care are nevoie. Uneori autorii includ o secțiune NUME, dar
plasați acolo text în formă liberă, mai degrabă decât „nume \- descriere”. Cu toate acestea, orice sintaxă
care seamănă cu cele de mai sus ar trebui acceptate.

Utilizați lexgrog online folosind serviciile onworks.net