lexgrog - Online nel cloud

PROGRAMMA:

NOME

lexgrog - analizza le informazioni di intestazione nelle pagine man

SINOSSI

lexgrog [-m|-c] [-dfw?V] [-E codifica] filetto ...

DESCRIZIONE

lexgrog è un'implementazione della tradizionale utility "groff guess" in lex. Si legge
l'elenco dei file sulla sua riga di comando come file sorgente della pagina man o preformattati
pagine "gatto" e visualizza il nome e la descrizione utilizzati da a proposito ed cosa è, le
elenco dei filtri di pre-elaborazione richiesti dalla pagina man prima che venga passata a nroff or
trof, o entrambi.

Se il suo input è formattato male, lexgrog stamperà "analisi fallita"; questo può essere utile per
programmi esterni che devono verificare la correttezza delle pagine man. Se uno di lexgrogl'input di
files è "-", leggerà dallo standard input; se un file di input è compresso, a
la versione decompressa verrà letta automaticamente.

VERSIONI

-d, - debug
Stampa le informazioni di debug.

-m, --uomo
Analizza l'input come file sorgente della pagina man. Questa è l'impostazione predefinita se nessuno dei due --uomo né
--gatto viene data.

-c, --gatto
Analizza l'input come pagine man preformattate ("pagine gatto"). --uomo ed --gatto potrebbe non essere
dato contemporaneamente.

-w, --Cos'è
Mostra il nome e la descrizione dall'intestazione della pagina man, come usato da a proposito ed
cosa è. Questa è l'impostazione predefinita se nessuno dei due --Cos'è né --filtri viene data.

-f, --filtri
Visualizza l'elenco dei filtri necessari per preelaborare la pagina man prima della formattazione
con nroff or trof.

-E codifica, - codifica codifica
Sostituisci il set di caratteri indovinato per la pagina a codifica.

-?, --Aiuto
Stampa un messaggio di aiuto ed esci.

--uso
Stampa un breve messaggio di utilizzo ed esci.

-V, --versione
Visualizza le informazioni sulla versione.

EXIT STATUS

0 Esecuzione riuscita del programma.

1 Errore di utilizzo.

2 lexgrog non è riuscito ad analizzare uno o più dei suoi file di input.

ESEMPI

$ lexgrog man.1
man.1: "man - un'interfaccia ai manuali di riferimento in linea"
$ lexgrog -fw man.1
man.1 (t): "man - un'interfaccia ai manuali di riferimento in linea"
$ lexgrog -c whatis.cat1
whatis.cat1: "whatis - visualizza le descrizioni delle pagine di manuale"
$ lexgrog rotto.1
rotto.1: analisi fallita

COS'È ANALISI

manb (che usa lo stesso codice di lexgrog) analizza il NOME sezione nella parte superiore di ogni
pagina di manuale alla ricerca di nomi e descrizioni delle funzionalità documentate in ciascuna. Mentre
il parser è abbastanza tollerante, in quanto deve far fronte a una serie di forme diverse che hanno
utilizzato storicamente, a volte può non riuscire a estrarre le informazioni richieste.

Quando si utilizza il tradizionale uomo set di macro, un corretto NOME la sezione assomiglia a qualcosa di simile
Questo:

.SH NOME
foo \- programma per fare qualcosa

Alcuni cercapersone manuali richiedono che '\-' sia esattamente come mostrato; manb è più tollerante, ma
per compatibilità con altri sistemi è comunque buona norma conservare il
barra rovesciata.

Sul lato sinistro possono essere presenti più nomi, separati da virgole. Nomi che contengono
gli spazi bianchi verranno ignorati per evitare comportamenti patologici su alcuni mal formati NOME
sezioni. Il testo sul lato destro è in forma libera e può essere distribuito su più
Linee. Se nello stesso documento vengono documentate più funzioni con descrizioni diverse
pagina di manuale, viene quindi utilizzato il seguente modulo:

.SH NOME
foo, bar \- programmi per fare qualcosa
. Br
baz \- programma per non fare nulla

(Una macro che inizia un nuovo paragrafo, come .PP, può essere usata al posto della macro break
.br.)

Quando si usa la derivata da BSD mdoc set di macro, un corretto NOME la sezione assomiglia a qualcosa di simile
Questo:

.Sh NOME
.Nm pippo
.Nd programma per fare qualcosa

Esistono diversi motivi comuni per cui l'analisi di whatis fallisce. A volte autori di manuali
pagine sostituire '.SH NAME' con '.SH MYPROGRAM', e poi manb non riesco a trovare la sezione da
quale estrarre le informazioni di cui ha bisogno. A volte gli autori includono una sezione NAME, ma
metti lì del testo in formato libero invece di 'nome \- descrizione'. Tuttavia, qualsiasi sintassi
simile a quanto sopra dovrebbe essere accettato.

Utilizzare lexgrog online utilizzando i servizi onworks.net