Provided by:
man-db_2.6.0.2-2_i386 
NAZWA
lexgrog - przetwarza naglowki stron podrcznika ekranowego
SK/LADNIA
lexgrog [-m|-c] [-fhwV] [-E kodowanie_znak'ow] plik ...
OPIS
lexgrog jest implementacj w lexie tradycyjnych narzdzi "zgadywanki
groffa". Ze swojej linii polece czyta list plikow, ktore mog by albo
rodlami stron podrcznika albo preformatowanymi stronami "cat", i
wywietla ich nazwy i opisy, tak jak s uywane przez apropos i whatis,
albo list filtrow preprocesora wymaganych przez stron podrcznika zanim
zostanie przekazana do nroff lub troff, albo obie te listy.
Jeeli wejcie lexgrog jest w zlym formacie, to wypisze on komunikat
"parse failed"; moe to by uyteczne dla zewntrznych programow
sprawdzajcych poprawno stron podrcznika. Jeeli jednym z plikow
wejciowych lexgroga jest "-", to bdzie czytal ze swojego standardowego
wejcia; jeli plik wejciowy jest skompresowany, to go automatycznie
zdekompresuje.
OPCJE
-m, --man
Przetwarza wejcie jako pliki rodlowe stron podrcznika
ekranowego. Jest to zachowanie domylne, jeli nie podano ani
--man, ani --cat.
-c, --cat
Przetwarza wejcie jako sformatowane wczeniej strony podrcznika
ekranowego ("strony cat"). --man i --cat nie mog by uyte
jednoczenie.
-w, --whatis
Wywietla nazw i opis z naglowka strony podrcznika ekranowego,
uywanego przez apropos i whatis. Jest to domylne zachowanie,
jeeli nie podano ani --whatis, ani --filters.
-f, --filters
Wywietla list filtrow potrzebnych do wstpnego przetworzenia
strony podrcznika zanim zostanie sformatowana przez program
nroff lub troff.
-E kodowanie_znak'ow, --encoding kodowanie_znak'ow
Nadpisuje odgadnite kodowanie znakow strony podrcznika,
ustawiajc je na kodowanie_znak'ow.
-h, --help
Wywietla komunikat pomocy i koczy prac.
-V, --version
Wywietla informacj o wersji.
KOD ZAKOCZENIA
0 Program zakoczony bez adnych bldow.
1 Bld uycia.
2 lexgrog nie umial przetworzy jednego lub wicej sporod plikow
wejciowych.
PRZYK/LADY
$ lexgrog man.1
man.1: "man - interfejs stron podrcznika ekranowego"
$ lexgrog -fw man.1
man.1 (t): "man - interfejs stron podrcznika ekranowego"
$ lexgrog -c whatis.cat1
whatis.cat1: "whatis - wywietla opisy stron podrcznika ekranowego"
$ lexgrog broken.1
broken.1: parse failed
PRZETWARZANIE WHATIS
mandb (oparty na tym samym kodzie, co lexgrog) przetwarza sekcj NAZWA
(NAME) znajdujc si samej gorze strony podrcznika ekranowego, szukajc w
niej nazw i opisow. Mimo e parser jest calkiem tolerancyjny, poniewa
musi sobie radzi z ronymi formatami, ktore byly uywane na przestrzeni
lat, to jednak czasem nie potrafi wycign potrzebnych informacji.
Jeeli uywany jest tradycyjny zbior makr man, to poprawna sekcja NAZWA
wyglda tak jak poniej:
.SH NAZWA
foo \- program, ktory co robi
Niektore programy do obslugi stron podrcznika wymagaj, aby separator
'\-' byl dokladnie taki, jak to pokazano; mandb jest bardziej
tolerancyjny, jednake w celu zachowania kompatybilnoci z innymi
systemami dobrym pomyslem jest pozostawienie znaku odwrotnego ukonika.
Po lewej stronie moe wystpowa kilka nazw, rozdzielonych od siebie
przecinkami. Nazwy zawierajce biale znaki s ignorowane, aby unikn
nieprawidlowego zachowania przy niektorych le sformatowanych sekcjach
NAZWA. Tekst po prawej stronie ma dowoln posta i moe zajmowa wiele
linii. Jeeli w tej samej stronie podrcznika udokumentowanych jest kilka
programow z ronymi opisami, powinna by uyta ponisza forma:
.SH NAZWA
foo, bar \- programy, ktore co robi
.br
baz \- program, ktory nic nie robi
(Zamiast makra .br mona uy makra, ktore zaczyna nowy akapit, na
przyklad .PP.)
Podczas uywania pochodzcego z systemow BSD zbioru makr mdoc poprawna
sekcja NAZWA powinna wyglda tak jak poniej:
.Sh NAZWA
.Nm foo
.Nd program, ktory co robi
Jest kilka powszechnych przyczyn, dla ktorych przetwarzanie whatis
koczy si fiaskiem. Czasami autorzy stron podrcznika zastpuj '.SH NAZWA'
przez '.SH MOJPROGRAM', co powoduje, e mandb nie potrafi odnale
potrzebnych informacji. Czasami autorzy umieszczaj wprawdzie sekcj
NAZWA, ale zawieraj w niej dowolny tekst zamiast uywa 'nazwa \- opis'.
Jednake kada skladania przypominajca powysz powinna by akceptowana.
ZOBACZ TAKE
man(1), mandb(8), apropos(1), whatis(1).
UWAGI
lexgrog probuje przetwarza pliki zawierajce dania .so, jednake bdzie
zdolny to zrobi tylko wtedy, gdy pliki te s poprawnie zainstalowane w
hierarchii stron podrcznika ekranowego.
AUTOR
Autorami kodu uywanego przez program lexgrog do przetwarzania stron
podrcznika s:
Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).
Colin Watson napisal obecne wcielnie interfejsu linii polece i t stron
podrcznika ekranowego.
T/LUMACZENIE
Wojciech Kotwica w 1999 roku przetlumaczyl cz stron podrcznika pakietu
man-db i udostpnil je w ramach Projektu Tlumaczenia Manuali.
Robert Luberda tlumaczenie zaktualizowal i uzupelnil w roku 2008.