.if !'po4a'hide' .ds mC CW .\" 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 docs/COPYING.GPLv2 that comes with the .\" man-db distribution. .\" .if t .if \n(.g .ds mC CR .if n .ds mC R . .\" in an example (EX/EE)? .nr mE 0 . .if !\n(.g \{\ .de EX . br . if !\\n(mE \{\ . nr mF \\n(.f . nr mP \\n(PD . nr PD 1v . nf . ft \\*(mC . nr mE 1 . \} .. .\} . . .if !\n(.g \{\ .de EE . br . if \\n(mE \{\ . ft \\n(mF . nr PD \\n(mP . fi . nr mE 0 . \} .. .\} .\" End example. . .pc "" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH LEXGROG 1 2026-11-16 2.13.3 "Rokasgrāmatu lapotāja rīki" .SH NOSAUKUMS lexgrog \- parsēt galvenes informāciju man lapās .SH KOPSAVILKUMS \fBlexgrog\fP [\|\fB\-m\fP\||\|\fB\-c\fP\|] [\|\fB\-dfw?V\fP\|] [\|\fB\-E\fP \fIkodējums\fP\|] \fIfails\fP \&.\|.\|. .SH APRAKSTS \fBlexgrog\fP ir tradicionālās \(lqgroff guess\(rq utilītas realizācija \fBlex\fP valodā. Tā nolasa komandrindā norādīto failu sarakstu kā man lapu avota failus vai iepriekš formatētas \(lqcat\(rq lapas un parāda to nosaukumu un aprakstu, kā tos izmanto \fBapropos\fP un \fBwhatis\fP, vai priekšapstrādes filtru sarakstu, kas man lapai nepieciešami, pirms tā tiek nodota \fBnroff\fP vai \fBtroff\fP, vai abus. .PP Ja ievade ir slikti formatēta, \fBlexgrog\fP izvadīs \(lqparse failed\(rq; tas var noderēt ārējām programmām, kurām jāpārbauda man lapu pareizība. Ja kāds no \fBlexgrog\fP ievades failiem ir \(lq\-\(rq, tā lasīs no standarta ievades; ja kāds ievades fails ir saspiests, automātiski tiks nolasīta tā atspiestā versija. .SH OPCIJAS .TP .if !'po4a'hide' .BR \-d ", " \-\-debug Izvadīt atkļūdošanas informāciju. .TP .if !'po4a'hide' .BR \-m ", " \-\-man Parsēt ievadi kā man lapu avota failus. Tas ir noklusējums, ja nav norādīts ne \fB\-\-man\fP, ne \fB\-\-cat\fP. .TP .if !'po4a'hide' .BR \-c ", " \-\-cat Parsēt ievadi kā iepriekš formatētas man lapas (\(lqcat lapas\(rq). \fB\-\-man\fP un \fB\-\-cat\fP nedrīkst norādīt vienlaikus. .TP .if !'po4a'hide' .BR \-w ", " \-\-whatis Parādīt nosaukumu un aprakstu no man lapas galvenes, kā tos izmanto \fBapropos\fP un \fBwhatis\fP. Tas ir noklusējums, ja nav norādīts ne \fB\-\-whatis\fP, ne \fB\-\-filters\fP. .TP .if !'po4a'hide' .BR \-f ", " \-\-filters Parādīt filtru sarakstu, kas nepieciešami man lapas priekšapstrādei pirms formatēšanas ar \fBnroff\fP vai \fBtroff\fP. .TP \fB\-E\fP \fIkodējums\fP, \fB\-\-encoding\fP \fIkodējums\fP Aizstāt lapai uzminēto rakstzīmju kopu ar \fIkodējumu\fP. .TP .if !'po4a'hide' .BR \-? ", " \-\-help Izvadīt palīdzības ziņojumu un iziet. .TP .if !'po4a'hide' .B \-\-usage Izvadīt īsu lietošanas ziņojumu un iziet. .TP .if !'po4a'hide' .BR \-V ", " \-\-version Parādīt versijas informāciju. .SH "IZPILDES STATUSS" .TP .if !'po4a'hide' .B 0 Veiksmīga programmas izpilde. .TP .if !'po4a'hide' .B 1 Lietošanas kļūda. .TP .if !'po4a'hide' .B 2 \fBlexgrog\fP neizdevās parsēt vienu vai vairākus ievades failus. .SH PIEMĒRI .nf $ lexgrog man.1 man.1: "man \- an interface to the system reference manuals" $ lexgrog \-fw man.1 man.1 (t): "man \- an interface to the system reference manuals" $ lexgrog \-c whatis.cat1 whatis.cat1: "whatis \- display manual page descriptions" $ lexgrog broken.1 broken.1: parse failed .fi .SH "WHATIS PARSĒŠANA" \fBmandb\fP (kas izmanto to pašu kodu, ko \fBlexgrog\fP) parsē \fBNAME\fP sadaļu katras rokasgrāmatas lapas sākumā, meklējot katrā dokumentēto līdzekļu nosaukumus un aprakstus. Lai gan parsētājs ir diezgan iecietīgs, jo tam jātiek galā ar vairākām vēsturiski lietotām formām, dažreiz tam var neizdoties izgūt vajadzīgo informāciju. .PP Izmantojot tradicionālo \fIman\fP makro kopu, pareiza \fBNAME\fP sadaļa izskatās apmēram šādi: .PP .RS .EX \&.SH NAME foo \e\- program to do something .EE .RE .PP Dažiem rokasgrāmatu lapotājiem nepieciešams, lai \(oq\e\-\(cq būtu tieši tāds, kā parādīts; \fBmandb\fP ir iecietīgāka, tomēr saderībai ar citām sistēmām ir ieteicams saglabāt atpakaļvērsto slīpsvītru. .PP Kreisajā pusē var būt vairāki nosaukumi, atdalīti ar komatiem. Nosaukumi, kas satur atstarpes, tiks ignorēti, lai izvairītos no patoloģiskas uzvedības dažās nepareizi veidotās \fBNAME\fP sadaļās. Teksts labajā pusē ir brīvas formas un var aizņemt vairākas rindas. Ja vienā rokasgrāmatas lapā tiek dokumentēti vairāki līdzekļi ar dažādiem aprakstiem, tāpēc tiek izmantota šāda forma: .PP .RS .EX \&.SH NAME foo, bar \e\- programs to do something \&.br baz \e\- program to do nothing .EE .RE .PP (Pārtraukuma makro \fB.br\fP vietā var izmantot makro, kas sāk jaunu rindkopu, piemēram, \fB.PP\fP.) .PP Izmantojot no BSD atvasināto \fImdoc\fP makro kopu, pareiza \fBNAME\fP sadaļa izskatās apmēram šādi: .PP .RS .EX \&.Sh NAME \&.Nm foo \&.Nd program to do something .EE .RE Ir vairāki bieži sastopami iemesli, kāpēc whatis parsēšana neizdodas. Dažreiz rokasgrāmatas lapu autori aizstāj \(oq.SH NAME\(cq ar \(oq.SH MYPROGRAM\(cq, un tad \fBmandb\fP nevar atrast sadaļu, no kuras izgūt vajadzīgo informāciju. Dažreiz autori iekļauj NAME sadaļu, bet tajā ievieto brīvas formas tekstu, nevis \(oqnosaukums \e\- apraksts\(cq. Tomēr jebkurai sintaksei, kas līdzinās iepriekš minētajai, vajadzētu tikt pieņemtai. .SH "SKATĪT ARĪ" .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 PIEZĪMES \fBlexgrog\fP mēģina parsēt failus, kas satur .so pieprasījumus, taču spēs to izdarīt pareizi tikai tad, ja faili ir pareizi instalēti rokasgrāmatas lapu hierarhijā. .SH AUTORS Kodu, ko \fBlexgrog\fP izmanto man lapu skenēšanai, uzrakstīja: .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 uzrakstīja pašreizējo komandrindas saskarnes versiju, kā arī šo man lapu. .SH KĻŪDAS .if !'po4a'hide' https://gitlab.com/man-db/man-db/\-/issues .br .if !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man\-db