<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">.\" Man page for lexgrog
.\"
.\" Copyright (c) 2001 Colin Watson &lt;cjwatson@debian.org&gt;
.\"
.\" 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 2019-01-05 2.8.5 "NarzÄ™dzia przeglÄ…darki stron podrÄ™cznika ekranowego"
.SH NAZWA
lexgrog \- przetwarza nagÅ‚Ã³wki stron podrÄ™cznika ekranowego
.SH SKÅADNIA
\fBlexgrog\fP [\|\fB\-m\fP\||\|\fB\-c\fP\|] [\|\fB\-dfw?V\fP\|] [\|\fB\-E\fP
\fIkodowanie_znakÃ³w\fP\|] \fIplik\fP \&amp;.\|.\|.
.SH OPIS
\fBlexgrog\fP jest implementacjÄ… w \fBlex\fPie tradycyjnych narzÄ™dzi
\(lqzgadywanki groffa\(rq. Ze swojej linii poleceÅ„ czyta listÄ™ plikÃ³w, ktÃ³re
mogÄ… byÄ‡ albo ÅºrÃ³dÅ‚ami stron podrÄ™cznika albo preformatowanymi stronami
\(lqcat\(rq, i wyÅ›wietla ich nazwy i opisy, tak jak sÄ… uÅ¼ywane przez
\fBapropos\fP i \fBwhatis\fP, albo listÄ™ filtrÃ³w preprocesora wymaganych przez
stronÄ™ podrÄ™cznika zanim zostanie przekazana do \fBnroff\fP lub \fBtroff\fP, albo
obie te listy.
.PP
JeÅ¼eli wejÅ›cie \fBlexgrog\fP jest w zÅ‚ym formacie, to wypisze on komunikat
\(lqparse failed\(rq; moÅ¼e to byÄ‡ uÅ¼yteczne dla zewnÄ™trznych programÃ³w
sprawdzajÄ…cych poprawnoÅ›Ä‡ stron podrÄ™cznika. JeÅ¼eli jednym z plikÃ³w
wejÅ›ciowych \fBlexgrog\fPa jest \(lq\-\(rq, to bÄ™dzie czytaÅ‚ ze swojego
standardowego wejÅ›cia; jeÅ›li plik wejÅ›ciowy jest skompresowany, to go
automatycznie zdekompresuje.
.SH OPCJE
.TP 
.if  !'po4a'hide' .BR \-d ", " \-\-debug
WyÅ›wietla informacjÄ™ diagnostycznÄ… (debug).
.TP 
.if  !'po4a'hide' .BR \-m ", " \-\-man
Przetwarza wejÅ›cie jako pliki ÅºrÃ³dÅ‚owe stron podrÄ™cznika ekranowego. Jest to
zachowanie domyÅ›lne, jeÅ›li nie podano ani \fB\-\-man\fP, ani \fB\-\-cat\fP.
.TP 
.if  !'po4a'hide' .BR \-c ", " \-\-cat
Przetwarza wejÅ›cie jako sformatowane wczeÅ›niej strony podrÄ™cznika ekranowego
(\(lqstrony cat\(rq). \fB\-\-man\fP i \fB\-\-cat\fP nie mogÄ… byÄ‡ uÅ¼yte jednoczeÅ›nie.
.TP 
.if  !'po4a'hide' .BR \-w ", " \-\-whatis
WyÅ›wietla nazwÄ™ i opis z nagÅ‚Ã³wka strony podrÄ™cznika ekranowego, uÅ¼ywanego
przez \fBapropos\fP i \fBwhatis\fP. Jest to domyÅ›lne zachowanie, jeÅ¼eli nie podano
ani \fB\-\-whatis\fP, ani \fB\-\-filters\fP.
.TP 
.if  !'po4a'hide' .BR \-f ", " \-\-filters
WyÅ›wietla listÄ™ filtrÃ³w potrzebnych do wstÄ™pnego przetworzenia strony
podrÄ™cznika zanim zostanie sformatowana przez program \fBnroff\fP lub \fBtroff\fP.
.TP 
\fB\-E\fP \fIkodowanie_znakÃ³w\fP, \fB\-\-encoding\fP \fIkodowanie_znakÃ³w\fP
Nadpisuje odgadniÄ™te kodowanie znakÃ³w strony podrÄ™cznika, ustawiajÄ…c je na
\fIkodowanie_znakÃ³w\fP.
.TP 
.if  !'po4a'hide' .BR \-? ", " \-\-help
WyÅ›wietla komunikat pomocy i koÅ„czy pracÄ™.
.TP 
.if  !'po4a'hide' .BR \-\-usage
WyÅ›wietla krÃ³tki opis uÅ¼ycia programu i koÅ„czy pracÄ™.
.TP 
.if  !'po4a'hide' .BR \-V ", " \-\-version
WyÅ›wietla informacjÄ™ o wersji.
.SH "KOD ZAKOÅƒCZENIA"
.TP 
.if  !'po4a'hide' .B 0
Program zakoÅ„czony bez Å¼adnych bÅ‚Ä™dÃ³w.
.TP 
.if  !'po4a'hide' .B 1
BÅ‚Ä…d uÅ¼ycia.
.TP 
.if  !'po4a'hide' .B 2
\fBlexgrog\fP nie umiaÅ‚ przetworzyÄ‡ jednego lub wiÄ™cej spoÅ›rÃ³d plikÃ³w
wejÅ›ciowych.
.SH PRZYKÅADY
.nf
  $ lexgrog man.1
  man.1: "man \- interfejs stron podrÄ™cznika ekranowego"
  $ lexgrog \-fw man.1
  man.1 (t): "man \- interfejs stron podrÄ™cznika ekranowego"
  $ lexgrog \-c whatis.cat1
  whatis.cat1: "whatis \- wyÅ›wietla opisy stron podrÄ™cznika ekranowego"
  $ lexgrog broken.1
  broken.1: parse failed
.fi
.SH "PRZETWARZANIE WHATIS"
\fBmandb\fP (oparty na tym samym kodzie, co \fBlexgrog\fP) przetwarza sekcjÄ™
\fBNAZWA\fP (\fBNAME\fP) znajdujÄ…cÄ… siÄ™ samej gÃ³rze strony podrÄ™cznika ekranowego,
szukajÄ…c w niej nazw i opisÃ³w. Mimo Å¼e parser jest caÅ‚kiem tolerancyjny,
poniewaÅ¼ musi sobie radziÄ‡ z roÅ¼nymi formatami, ktÃ³re byÅ‚y uÅ¼ywane na
przestrzeni lat, to jednak czasem nie potrafi wyciÄ…gnÄ…Ä‡ potrzebnych
informacji.
.PP
JeÅ¼eli uÅ¼ywany jest tradycyjny zbiÃ³r makr \fIman\fP, to poprawna sekcja
\fBNAZWA\fP wyglÄ…da tak jak poniÅ¼ej:
.PP
.RS
.nf
\f(CW\&amp;.SH NAZWA
foo \e\- program, ktÃ³ry coÅ› robi\fP
.fi
.RE
.PP
NiektÃ³re programy do obsÅ‚ugi stron podrÄ™cznika wymagajÄ…, aby separator
\(oq\e\-\(cq byÅ‚ dokÅ‚adnie taki, jak to pokazano; \fBmandb\fP jest bardziej
tolerancyjny, jednakÅ¼e w celu zachowania kompatybilnoÅ›ci z innymi systemami
dobrym pomysÅ‚em jest pozostawienie znaku odwrotnego ukoÅ›nika.
.PP
Po lewej stronie moÅ¼e wystÄ™powaÄ‡ kilka nazw, rozdzielonych od siebie
przecinkami. Nazwy zawierajÄ…ce biaÅ‚e znaki sÄ… ignorowane, aby uniknÄ…Ä‡
nieprawidÅ‚owego zachowania przy niektÃ³rych Åºle sformatowanych sekcjach
\fBNAZWA\fP. Tekst po prawej stronie ma dowolnÄ… postaÄ‡ i moÅ¼e zajmowaÄ‡ wiele
linii. JeÅ¼eli w tej samej stronie podrÄ™cznika udokumentowanych jest kilka
programÃ³w z rÃ³Å¼nymi opisami, powinna byÄ‡ uÅ¼yta poniÅ¼sza forma:
.PP
.RS
.nf
\f(CW\&amp;.SH NAZWA
foo, bar \e\- programy, ktÃ³re coÅ› robiÄ…
\&amp;.br
baz \e\- program, ktÃ³ry nic nie robi\fP
.fi
.RE
.PP
(Zamiast makra \f(CW.br\fP moÅ¼na uÅ¼yÄ‡ makra, ktÃ³re zaczyna nowy akapit, na
przykÅ‚ad \f(CW.PP\fP.)
.PP
Podczas uÅ¼ywania pochodzÄ…cego z systemÃ³w BSD zbioru makr \fImdoc\fP poprawna
sekcja \fBNAZWA\fP powinna wyglÄ…daÄ‡ tak jak poniÅ¼ej:
.PP
.RS
.nf
\f(CW\&amp;.Sh NAZWA
\&amp;.Nm foo
\&amp;.Nd program, ktÃ³ry coÅ› robi\fP
.fi
.RE

Jest kilka powszechnych przyczyn, dla ktÃ³rych przetwarzanie whatis koÅ„czy
siÄ™ fiaskiem. Czasami autorzy stron podrÄ™cznika zastÄ™pujÄ… \(oq.SH NAZWA\(cq
przez \(oq.SH MÃ“JPROGRAM\(cq, co powoduje, Å¼e \fBmandb\fP nie potrafi
odnaleÅºÄ‡ potrzebnych informacji. Czasami autorzy umieszczajÄ… wprawdzie
sekcjÄ™ NAZWA, ale zawierajÄ… w niej dowolny tekst zamiast uÅ¼ywaÄ‡ \(oqnazwa
\e\- opis\(cq. JednakÅ¼e kaÅ¼da skÅ‚adania przypominajÄ…ca powyÅ¼szÄ… powinna byÄ‡
akceptowana.
.SH "ZOBACZ TAKÅ»E"
.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 UWAGI
\fBlexgrog\fP prÃ³buje przetwarzaÄ‡ pliki zawierajÄ…ce Å¼Ä…dania .so, jednakÅ¼e
bÄ™dzie zdolny to zrobiÄ‡ tylko wtedy, gdy pliki te sÄ… poprawnie zainstalowane
w hierarchii stron podrÄ™cznika ekranowego.
.SH AUTOR
Autorami kodu uÅ¼ywanego przez program \fBlexgrog\fP do przetwarzania stron
podrÄ™cznika sÄ…:
.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 napisaÅ‚ obecne wcielnie interfejsu linii poleceÅ„ i tÄ™ stronÄ™
podrÄ™cznika ekranowego.
.SH TÅUMACZENIE
Wojciech Kotwica w 1999 roku przetÅ‚umaczyÅ‚ czÄ™Å›Ä‡ stron podrÄ™cznika pakietu 
man-db i udostÄ™pniÅ‚ je w ramach Projektu TÅ‚umaczenia Manuali. 
.br
Robert Luberda tÅ‚umaczenie zaktualizowaÅ‚ i uzupeÅ‚niÅ‚ w roku 2008.
</pre></body></html>