LEXGROG(1) Verktyg for sidvisning av manual LEXGROG(1) NAMN lexgrog - tolka rubrikhuvud i manualsidor SYNOPSIS lexgrog [-m|-c] [-dfw?V] [-E kodning] fil ... BESKRIVNING lexgrog ar en implementation av det traditionella verktyget "groff guess" i lex. Det laser listan av filer pa dess kommandorad antingen som kallkodsfiler till manualsidor eller forformaterade "cat" sidor, och visar deras namn och beskrivning sa som de anvands av apropos och whatis, som en lista av preprocessorfilter som kravs av manualsidan innan den skickas vidare till nroff eller troff, eller bada delar. Om inmatningen ar daligt formaterad kommer lexgrog att skriva ut "tolkning misslyckades"; detta kan vara anvandbart for externa program som behover kontrollera manualsidors korrekthet. Om en av lexgrog:s inmatningsfiler ar "-" sa kommer det att lasa fran standard in; om nagon inmatningsfil ar komprimerad kommer en dekomprimerad version automatiskt att lasas in. FLAGGOR -d, --debug Skriver ut felsokningsinformation. -m, --man Tolka inmatning som kallkodsfiler till manualsidor. Detta ar standard om varken --man eller --cat anges. -c, --cat Tolka inmatning som forformaterade manualsidor ("cat-sidor"). --man och --cat far inte anges samtidigt. -w, --whatis Visa namnet och beskrivningen fran manualsidans rubrikhuvud sa som de anvands av apropos och whatis. Detta ar standard om varken --whatis eller --filters anges. -f, --filters Visa listan over filter som behovs for att forformatera manualsidan innan den formateras med nroff eller troff. -E kodning, --encoding kodning Asidosatt den gissade teckenuppsattningen for sidan och anvand kodning. -?, --help Skriv ut ett hjalpmeddelande och avsluta. --usage Skriv ut ett kort anvandningsmeddelande och avsluta. -V, --version Visa versionsinformation. SLUTSTATUS 0 Framgangsrik programexekvering. 1 Anvandningsfel. 2 lexgrog misslyckades med att tolka en eller flera av dess inmatningsfiler. EXEMPEL $ lexgrog man.1 man.1: "man - ett granssnitt for systemreferensmanualer" $ lexgrog -fw man.1 man.1 (t): "man - ett granssnitt for systemreferensmanualer" $ lexgrog -c whatis.cat1 whatis.cat1: "whatis - visa beskrivningar for manualsidor" $ lexgrog broken.1 broken.1: tolkning misslyckades WHATIS-TOLKNING mandb (som anvander samma kod som lexgrog) tolkar NAMN-avsnittet langst upp pa varje manualsida och letar efter namn och beskrivningar for de funktioner som dokumenteras i varje sida. Aven om tolken ar tamligen tolerant, da den varit tvungen att klara av ett antal olika format som anvants historiskt, kan den ibland misslyckas med att extrahera den begarda informationen. Nar den traditionella makrouppsattningen man anvands ser ett NAMN-avsnitt ut ungefar sa har: .SH NAMN foo \- program som gor nagonting Vissa manualsidor kraver att `\-' anges exakt som visats; mandb ar mer tolerant, men for kompatibilitet med andra system ar det trots detta en bra ide att behalla bakstrecket. Pa vanstersidan kan det finnas flera namn, separerade av komman. Namn som innehaller blanksteg kommer att ignoreras for att undvika felaktigt beteende for vissa daligt namngivna NAMN-avsnitt. Texten pa hoger sida ar friformstext och far stracka sig over flera rader. Om flera funktioner med olika beskrivningar dokumenteras pa samma manualsida ska darfor foljande form anvandas: .SH NAMN foo, bar \- program som gor nagonting .br baz \- program som inte gor nagonting (Ett makro som paborjar ett nytt stycke, sa som .PP, kan anvandas istallet for avbrytningsmakrot .br.) Nar den BSD-baserade makrouppsattningen mdoc anvands ser ett NAMN-avsnitt ut ungefar sa har: .Sh NAMN .Nm foo .Nd program som gor nagonting Det finns flera anledningar till varfor whatis-tolkning misslyckas. Ibland ersatter upphovsmannen till manualsidorna `.SH NAMN' med `.SH MITTPROGRAM' och sa kan inte mandb hitta avsnittet fran vilket informationen det behover ska extraheras. Ibland inkluderar upphovsmannen NAMN-avsnittet, men placerar friformstext dar snarare an `namn \- beskrivning'. Syntax som ar lik ovanstaende bor dock accepteras. SE VIDARE apropos(1), man(1), whatis(1), mandb(8) NOTERINGAR lexgrog forsoker att tolka filer som innehaller .so-begaran men kommer endast att lyckas gora det korrekt om filerna ar korrekt installerade i hierarkin av manualsidor. UPPHOVSMAN Koden som anvands av lexgrog for att genomsoka manualsidor skrevs av: Wilf. (G.Wilford@ee.surrey.ac.uk). Fabrizio Polacco (fpolacco@debian.org). Colin Watson (cjwatson@debian.org). Colin Watson skrev den innevarande inkarnationen av kommandoradsgranssnittet, saval som denna manualsida. FEL https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db 2.12.1 2024-04-05 LEXGROG(1)