.\" Man page for lexgrog .\" .\" Copyright (c) 2001 Colin Watson .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the file COPYING that comes with the .\" man-db distribution. .pc "" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH LEXGROG 1 2021-02-08 2.9.4 "Utilități de pager de manual" .SH NUME lexgrog \- parsează informații de antet în paginile manualului .SH REZUMAT \fBlexgrog\fP [\|\fB\-m\fP\||\|\fB\-c\fP\|] [\|\fB\-dfw?V\fP\|] [\|\fB\-E\fP \fIencoding\fP\|] \fIfile\fP \&.\|.\|. .SH DESCRIERE \fBlexgrog\fP este o implementare a utilității tradiționale \(lqgroff în \fBlex\fP. Aceasta citește lista de fișiere din linia de comandă ori ca fișiere sursă a paginilor de manual ori ca pagini preformatate \(lqcat\(rq, și afișează numele și descrierea așa cum sunt utilizate de \fBapropos\fP și \fBwhatis\fP, lista de filtre de preprocesare necesară de pagina de manual înainte să fie pasată la \fBnroff\fP sau \fBtroff\fP, sau amândouă. .PP Dacă intrarea acesteia este formatată greșit, \fBlexgrog\fP va tipări \(lqparse failed\(rq; aceasta poate fi utilă pentru programe externe care au nevoie să verifice paginile de manual pentru corectitudine. Dacă unul dintre fișierele de intrare ale \fBlexgrog\fP este \(lq\-\(rq, va citi de la intrarea standard; dacă orice fișier de intrare este comprimat, o versiune decomprimată va fi citită automat. .SH OPȚIUNI .TP .if !'po4a'hide' .BR \-d ", " \-\-debug Tipărește informațiile de depanare. .TP .if !'po4a'hide' .BR \-m ", " \-\-man Parsează intrarea ca fișiere sursă de pagini de manual. Acest lucru este implicit dacă niciuna dintre \fB\-\-man\fP sau \fB\-\-cat\fP nu sunt date. .TP .if !'po4a'hide' .BR \-c ", " \-\-cat Parsează intrarea ca pagini de manual preformatate (\(lqcat pages\(rq). \fB\-\-man\fP și \fB\-\-cat\fP pot să nu fie date simultan. .TP .if !'po4a'hide' .BR \-w ", " \-\-whatis Afișează numele și descrierea de la antetul de pagină de manual, așa cum este utilizat de \fBapropos\fP și \fBwhatis\fP. Acest lucru este implicit dacă niciuna dintre \fB\-\-whatis\fP sau \fB\-\-filters\fP nu sunt date. .TP .if !'po4a'hide' .BR \-f ", " \-\-filters Afișează lista de filtre necesare pentru a preprocesa pagina manualului înainte de a formata cu \fBnroff\fP sau \fBtroff\fP. .TP \fB\-E\fP \fIencoding\fP, \fB\-\-encoding\fP \fIencoding\fP Suprascrie setul de caractere ghicit pentru pagină la \fIencoding\fP. .TP .if !'po4a'hide' .BR \-? ", " \-\-help Tipărește un mesaj de ajutor și ieși. .TP .if !'po4a'hide' .B \-\-usage Tipărește un mesaj de utilizare scurt și ieși. .TP .if !'po4a'hide' .BR \-V ", " \-\-version Afișează informațiile de versiune. .SH "STARE DE IEȘIRE" .TP .if !'po4a'hide' .B 0 Executare a programului cu succes. .TP .if !'po4a'hide' .B 1 Eroare de utilizare. .TP .if !'po4a'hide' .B 2 \fBlexgrog\fP a eșuat în a parsa unul sau mai multe dintre fișierele de intrare. .SH EXEMPLE .nf $ lexgrog man.1 man.1: "man \- o interfață la manualele de referință a sistemului" $ lexgrog \-fw man.1 man.1 (t): "man \- o interfață la manualele de referință a sistemului" $ lexgrog \-c whatis.cat1 whatis.cat1: "whatis \- afișează descrieri de pagină de manual" $ lexgrog defect.1 broken.1: parsarea a eșuat .fi .SH "PARSARE WHATIS" \fBmandb\fP (care utilizează același cod ca \fBlexgrog\fP) parsează secțiunea \fBNAME\fP la începutul fiecărei pagini de manual căutând după nume și descrieri ale funcționalităților documentate în fiecare. În timp ce parsatorul este chiar tolerant, pentru că trebuie să se descurce cu un număr de forme diferite care au fost utilizate istoric, acesta poate câteodată să eșueze să extragă informațiile necesare. .PP Când se utilizează setul de macro tradițional \fIman\fP, o secțiune corectă \fBNAME\fP arată cam așa: .PP .RS .nf \f(CW\&.SH NAME foo \e\- programul pentru a face ceva\fP .fi .RE .PP Unele pagere de manual necesită \(oq\e\-\(cq să fie exact așa cum este arătat; \fBmandb\fP este mai tolerant, dar pentru compatibilitatea cu alte sisteme este totuși o idee bună să se rețină linia oblică inversă. .PP În partea din stânga, este posibil să fie mai multe nume, separate prin virgule. Numele care conțin spații albe vor fi ignorate pentru a evita comportamentul patologic la anumite secțiuni \fBNAME\fP malformate. Textul din partea dreaptă este în formă liberă, și poate fi extins peste linii multiple. Dacă mai multe funcționalități cu descrieri diferite sunt documentate în aceeași pagină de manual, următorul formular este, prin urmare, utilizat: .PP .RS .nf \f(CW\&.SH NAME foo, bar \e\- programe pentru a face ceva \&.br baz \e\- program pentru a nu face nimic\fP .fi .RE .PP (Un macro care începe un paragraf nou, precum \f(CW.PP\fP, poate fi utilizat în locul macro\-ului de întrerupere \f(CW.br\fP.) .PP Când se utilizează setul macro \fImdoc\fP derivat BSD, o secțiune \fBNAME\fP corectă arată cam așa: .PP .RS .nf \f(CW\&.Sh NAME \&.Nm foo \&.Nd program pentru a face ceva\fP .fi .RE Există mai multe motive comune pentru care parsarea whatis eșuează. Câteodată autorii paginilor de manual înlocuiesc \(oq.SH NAME\(cq cu \(oq.SH MYPROGRAM\(cq și apoi \fBmandb\fP nu poate găsi secțiunea de la care să extragă informațiile de care are nevoie. Câteodată autorii includ o secțiune NUME, dar plasează text în formă liberă acolo în locul \(oqname \e\- description\(cq. Totuși, orice sintaxă care se aseamănă cu cea de deasupra ar trebui să fie acceptată. .SH "VEDEȚI ȘI" .if !'po4a'hide' .IR apropos (1), .if !'po4a'hide' .IR man (1), .if !'po4a'hide' .IR whatis (1), .if !'po4a'hide' .IR mandb (8) .SH NOTE \fBlexgrog\fP încearcă să parseze fișiere care conțin cereri .so, dar va putea să facă acest lucru corect doar dacă fișierele sunt instalate cum trebuie într\-o ierarhie de pagină de manual. .SH AUTOR Codul utilizat de \fBlexgrog\fP pentru a scana paginile de manual a fost scris de: .PP .nf .if !'po4a'hide' Wilf.\& (G.Wilford@ee.surrey.ac.uk). .if !'po4a'hide' Fabrizio Polacco (fpolacco@debian.org). .if !'po4a'hide' Colin Watson (cjwatson@debian.org). .fi .PP Colin Watson a scris încarnarea curentă a interfeței liniei de comandă, precum și această pagină de manual. .SH DEFECȚIUNI .if !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man-db