Dit is de opdracht lexgrog die kan worden uitgevoerd in de gratis hostingprovider van OnWorks met behulp van een van onze meerdere gratis online werkstations zoals Ubuntu Online, Fedora Online, Windows online emulator of MAC OS online emulator
PROGRAMMA:
NAAM
lexgrog - ontleed headerinformatie in manpagina's
KORTE INHOUD
Lexgrog [-m|-c] [-dfw?V] [-E codering] filet ...
PRODUCTBESCHRIJVING
Lexgrog is een implementatie van het traditionele 'groff raden'-hulpprogramma in lex. Er staat
de lijst met bestanden op de opdrachtregel als manpage-bronbestanden of als vooraf opgemaakte bestanden
"kat"-pagina's en toont hun naam en beschrijving zoals gebruikt door a propos en wat is
lijst met voorverwerkingsfilters die vereist zijn door de manpagina voordat deze wordt doorgegeven nroff or
troff, of allebei.
Als de invoer slecht is geformatteerd, Lexgrog zal "parseren mislukt" afdrukken; dit kan nuttig zijn voor
externe programma's die manpagina's moeten controleren op juistheid. Als een van Lexgrog's inbreng
bestanden is “-”, het leest van standaardinvoer; als een invoerbestand is gecomprimeerd, a
de gedecomprimeerde versie wordt automatisch gelezen.
OPTIES
-d, --debuggen
Foutopsporingsinformatie afdrukken.
-m, --Mens
Parseer invoer als bronbestanden van manpagina's. Dit is de standaardinstelling als geen van beide --Mens noch
--kat is gegeven.
-c, --kat
Parseer invoer als vooraf opgemaakte manpagina's ("cat-pagina's"). --Mens en --kat is misschien niet
gelijktijdig gegeven.
-w, --wat is
Geef de naam en beschrijving weer uit de koptekst van de manpagina, zoals gebruikt door a propos en
wat is. Dit is de standaardinstelling als geen van beide --wat is noch --filters is gegeven.
-f, --filters
Geef de lijst met filters weer die nodig zijn om de manpagina voor te verwerken vóór het formatteren
Met nroff or troff.
-E codering, --codering codering
Overschrijf de geraden tekenset voor de pagina codering.
-?, --help
Druk een helpbericht af en sluit af.
--gebruik
Druk een kort gebruiksbericht af en sluit af.
-V, --versie
Versie-informatie weergeven.
EXIT STATUS
0 Succesvolle uitvoering van het programma.
1 Gebruiksfout.
2 Lexgrog kon een of meer invoerbestanden niet parseren.
Voorbeelden
$ lexgrog man.1
man.1: "man - een interface naar de online referentiehandleidingen"
$ lexgrog -fw man.1
man.1 (t): "man - een interface naar de online referentiehandleidingen"
$ lexgrog -c wat is.cat1
whatis.cat1: "whatis - beschrijvingen van handleidingpagina's weergeven"
$ lexgrog kapot.1
gebroken.1: parseren mislukt
WAT IS PARSEREN
mandb (die dezelfde code gebruikt als Lexgrog) parseert de NAAM gedeelte bovenaan elk
handleidingpagina op zoek naar namen en beschrijvingen van de functies die in elk document zijn gedocumenteerd. Terwijl
de parser is behoorlijk tolerant, omdat hij te maken heeft met een aantal verschillende vormen
historisch gebruikt, kan het soms mislukken om de vereiste informatie te verkrijgen.
Bij gebruik van de traditionele man macroset, een correcte NAAM sectie ziet er ongeveer zo uit
deze:
.SH NAAM
foo \- programma om iets te doen
Bij sommige handmatige pagers moet de '\-' precies zo zijn als weergegeven; mandb is toleranter, maar
voor compatibiliteit met andere systemen is het toch een goed idee om de
terugslag.
Aan de linkerkant kunnen er meerdere namen staan, gescheiden door komma's. Namen bevatten
witruimte wordt genegeerd om pathologisch gedrag bij bepaalde slecht gevormde personen te voorkomen NAAM
secties. De tekst aan de rechterkant is in vrije vorm en kan over meerdere worden verspreid
lijnen. Als er meerdere kenmerken met verschillende beschrijvingen in hetzelfde document worden gedocumenteerd
manpagina, wordt daarom de volgende vorm gebruikt:
.SH NAAM
foo, bar \- programma's om iets te doen
. Br
baz \- programma om niets te doen
(Een macro die een nieuwe alinea begint, zoals .PP, kan worden gebruikt in plaats van de afbreekmacro
.br.)
Bij gebruik van het van BSD afgeleide mdoc macroset, een correcte NAAM sectie ziet er ongeveer zo uit
deze:
.S NAAM
.Nm foo
.Nd-programma om iets te doen
Er zijn verschillende veelvoorkomende redenen waarom het parseren van Whatis mislukt. Soms auteurs van handleidingen
pagina's vervangen '.SH NAME' door '.SH MYPROGRAM', en vervolgens mandb kan het gedeelte niet vinden
waaruit hij de informatie kan halen die hij nodig heeft. Soms voegen auteurs een NAME-sectie toe, maar
plaats daar vrije tekst in plaats van 'naam \- beschrijving'. Echter, elke syntaxis
die op het bovenstaande lijken, moeten worden aanvaard.
Gebruik lexgrog online met behulp van onworks.net-services
