{"id":6396,"date":"2022-12-20T18:58:18","date_gmt":"2022-12-20T21:58:18","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/lexgrog-pl\/"},"modified":"2022-12-20T18:58:18","modified_gmt":"2022-12-20T21:58:18","slug":"lexgrog-pl","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/lexgrog-pl\/","title":{"rendered":"LEXGROG (pl)"},"content":{"rendered":"

LEXGROG<\/h1>\n

NAZWA<\/a>
SK\u00c5ADNIA<\/a>
OPIS<\/a>
OPCJE<\/a>
KOD ZAKO\u00c5CZENIA<\/a>
PRZYK\u00c5ADY<\/a>
PRZETWARZANIE WHATIS<\/a>
ZOBACZ TAK\u00c5\u00bbE<\/a>
UWAGI<\/a>
AUTOR<\/a>
B\u00c5\u00c4DY<\/a>
T\u00c5UMACZENIE<\/a> <\/p>\n

\n

NAZWA <\/a> <\/h2>\n

lexgrog \u2212 przetwarza nag\u00c5\u00c3\u00b3wki stron podr\u00c4cznika ekranowego<\/p>\n

SK\u00c5ADNIA <\/a> <\/h2>\n

lexgrog<\/b> [\u2212m<\/b>|\u2212c<\/b>] [\u2212dfw?V<\/b>] [\u2212E<\/b> kodowanie_znak\u00c3\u00b3w<\/i>] plik<\/i> …<\/p>\n

OPIS <\/a> <\/h2>\n

lexgrog<\/b> jest implementacj\u00c4 w lex<\/b>ie tradycyjnych narz\u00c4dzi \u201czgadywanki groffa\u201d. Ze swojej linii polece\u00c5 czyta list\u00c4 plik\u00c3\u00b3w, kt\u00c3\u00b3re mog\u00c4 by\u00c4 albo \u00c5\u00bar\u00c3\u00b3d\u00c5ami stron podr\u00c4cznika albo preformatowanymi stronami \u201ccat\u201d, i wy\u00c5wietla ich nazwy i opisy, tak jak s\u00c4 u\u00c5\u00bcywane przez apropos<\/b> i whatis<\/b>, albo list\u00c4 filtr\u00c3\u00b3w preprocesora wymaganych przez stron\u00c4 podr\u00c4cznika zanim zostanie przekazana do nroff<\/b> lub troff<\/b>, albo obie te listy.<\/p>\n

Je\u00c5\u00bceli wej\u00c5cie lexgrog<\/b> jest w z\u00c5ym formacie, to wypisze on komunikat \u201cparse failed\u201d; mo\u00c5\u00bce to by\u00c4 u\u00c5\u00bcyteczne dla zewn\u00c4trznych program\u00c3\u00b3w sprawdzaj\u00c4cych poprawno\u00c5\u00c4 stron podr\u00c4cznika. Je\u00c5\u00bceli jednym z plik\u00c3\u00b3w wej\u00c5ciowych lexgrog<\/b>a jest \u201c\u2212\u201d, to b\u00c4dzie czyta\u00c5 ze swojego standardowego wej\u00c5cia; je\u00c5li plik wej\u00c5ciowy jest skompresowany, to go automatycznie zdekompresuje.<\/p>\n

OPCJE <\/a> <\/h2>\n

\u2212d<\/b>, \u2212\u2212debug<\/b><\/p>\n

Wy\u00c5wietla informacj\u00c4 diagnostyczn\u00c4 (debug).<\/p>\n

\u2212m<\/b>, \u2212\u2212man<\/b><\/p>\n

Przetwarza wej\u00c5cie jako pliki \u00c5\u00bar\u00c3\u00b3d\u00c5owe stron podr\u00c4cznika ekranowego. Jest to zachowanie domy\u00c5lne, je\u00c5li nie podano ani \u2212\u2212man<\/b>, ani \u2212\u2212cat<\/b>.<\/p>\n

\u2212c<\/b>, \u2212\u2212cat<\/b><\/p>\n

Przetwarza wej\u00c5cie jako sformatowane wcze\u00c5niej strony podr\u00c4cznika ekranowego (\u201cstrony cat\u201d). \u2212\u2212man<\/b> i \u2212\u2212cat<\/b> nie mog\u00c4 by\u00c4 u\u00c5\u00bcyte jednocze\u00c5nie.<\/p>\n

\u2212w<\/b>, \u2212\u2212whatis<\/b><\/p>\n

Wy\u00c5wietla nazw\u00c4 i opis z nag\u00c5\u00c3\u00b3wka strony podr\u00c4cznika ekranowego, u\u00c5\u00bcywanego przez apropos<\/b> i whatis<\/b>. Jest to domy\u00c5lne zachowanie, je\u00c5\u00bceli nie podano ani \u2212\u2212whatis<\/b>, ani \u2212\u2212filters<\/b>.<\/p>\n

\u2212f<\/b>, \u2212\u2212filters<\/b><\/p>\n

Wy\u00c5wietla list\u00c4 filtr\u00c3\u00b3w potrzebnych do wst\u00c4pnego przetworzenia strony podr\u00c4cznika zanim zostanie sformatowana przez program nroff<\/b> lub troff<\/b>.<\/p>\n

\u2212E<\/b> kodowanie_znak\u00c3\u00b3w<\/i>, \u2212\u2212encoding<\/b> kodowanie_znak\u00c3\u00b3w<\/i><\/p>\n

Nadpisuje odgadni\u00c4te kodowanie znak\u00c3\u00b3w strony podr\u00c4cznika, ustawiaj\u00c4c je na kodowanie_znak\u00c3\u00b3w<\/i>.<\/p>\n

\u2212?<\/b>, \u2212\u2212help<\/b><\/p>\n

Wy\u00c5wietla komunikat pomocy i ko\u00c5czy prac\u00c4.<\/p>\n

\u2212\u2212usage<\/b><\/p>\n

Wy\u00c5wietla kr\u00c3\u00b3tki opis u\u00c5\u00bcycia programu i ko\u00c5czy prac\u00c4.<\/p>\n

\u2212V<\/b>, \u2212\u2212version<\/b><\/p>\n

Wy\u00c5wietla informacj\u00c4 o wersji.<\/p>\n

KOD ZAKO\u00c5CZENIA <\/a> <\/h2>\n\n\n\n\n
<\/td>\n\n

0<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Program zako\u00c5czony bez \u00c5\u00bcadnych b\u00c5\u00c4d\u00c3\u00b3w.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

1<\/b><\/p>\n<\/td>\n

<\/td>\n\n

B\u00c5\u00c4d u\u00c5\u00bcycia.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

2<\/b><\/p>\n<\/td>\n

<\/td>\n\n

lexgrog<\/b> nie umia\u00c5 przetworzy\u00c4 jednego lub wi\u00c4cej spo\u00c5r\u00c3\u00b3d plik\u00c3\u00b3w wej\u00c5ciowych.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

PRZYK\u00c5ADY <\/a> <\/h2>\n

$ lexgrog man.1
man.1: “man \u2212 an interface to the system reference manuals”
$ lexgrog \u2212fw man.1
man.1 (t): “man \u2212 an interface to the system reference manuals”
$ lexgrog \u2212c whatis.cat1
whatis.cat1: “whatis \u2212 display manual page descriptions”
$ lexgrog broken.1
broken.1: parse failed<\/p>\n

PRZETWARZANIE WHATIS <\/a> <\/h2>\n

mandb<\/b> (oparty na tym samym kodzie, co lexgrog<\/b>) przetwarza sekcj\u00c4 NAZWA<\/b> (NAME<\/b>) znajduj\u00c4c\u00c4 si\u00c4 samej g\u00c3\u00b3rze strony podr\u00c4cznika ekranowego, szukaj\u00c4c w niej nazw i opis\u00c3\u00b3w. Mimo \u00c5\u00bce parser jest ca\u00c5kiem tolerancyjny, poniewa\u00c5\u00bc musi sobie radzi\u00c4 z ro\u00c5\u00bcnymi formatami, kt\u00c3\u00b3re by\u00c5y u\u00c5\u00bcywane na przestrzeni lat, to jednak czasem nie potrafi wyci\u00c4gn\u00c4\u00c4 potrzebnych informacji.<\/p>\n

Je\u00c5\u00bceli u\u00c5\u00bcywany jest tradycyjny zbi\u00c3\u00b3r makr man<\/i>, to poprawna sekcja NAZWA<\/b> wygl\u00c4da tak jak poni\u00c5\u00bcej:<\/p>\n

.SH NAZWA
foo \u2212 program, kt\u00c3\u00b3ry co\u00c5 robi<\/p>\n

Niekt\u00c3\u00b3re programy do obs\u00c5ugi stron podr\u00c4cznika wymagaj\u00c4, aby separator \u2018\u2212\u2019 by\u00c5 dok\u00c5adnie taki, jak to pokazano; mandb<\/b> jest bardziej tolerancyjny, jednak\u00c5\u00bce w celu zachowania kompatybilno\u00c5ci z innymi systemami dobrym pomys\u00c5em jest pozostawienie znaku odwrotnego uko\u00c5nika.<\/p>\n

Po lewej stronie mo\u00c5\u00bce wyst\u00c4powa\u00c4 kilka nazw, rozdzielonych od siebie przecinkami. Nazwy zawieraj\u00c4ce bia\u00c5e znaki s\u00c4 ignorowane, aby unikn\u00c4\u00c4 nieprawid\u00c5owego zachowania przy niekt\u00c3\u00b3rych \u00c5\u00bale sformatowanych sekcjach NAZWA<\/b>. Tekst po prawej stronie ma dowoln\u00c4 posta\u00c4 i mo\u00c5\u00bce zajmowa\u00c4 wiele linii. Je\u00c5\u00bceli w tej samej stronie podr\u00c4cznika udokumentowanych jest kilka program\u00c3\u00b3w z r\u00c3\u00b3\u00c5\u00bcnymi opisami, powinna by\u00c4 u\u00c5\u00bcyta poni\u00c5\u00bcsza forma:<\/p>\n

.SH NAZWA
foo, bar \u2212 programy, kt\u00c3\u00b3re co\u00c5 robi\u00c4
.br
baz \u2212 program, kt\u00c3\u00b3ry nic nie robi<\/p>\n

(Zamiast makra .br mo\u00c5\u00bcna u\u00c5\u00bcy\u00c4 makra, kt\u00c3\u00b3re zaczyna nowy akapit, na przyk\u00c5ad .PP.)<\/p>\n

Podczas u\u00c5\u00bcywania pochodz\u00c4cego z system\u00c3\u00b3w BSD zbioru makr mdoc<\/i> poprawna sekcja NAZWA<\/b> powinna wygl\u00c4da\u00c4 tak jak poni\u00c5\u00bcej:<\/p>\n

.Sh NAZWA
.Nm foo
.Nd program, kt\u00c3\u00b3ry co\u00c5 robi<\/p>\n

Jest kilka powszechnych przyczyn, dla kt\u00c3\u00b3rych przetwarzanie whatis ko\u00c5czy si\u00c4 fiaskiem. Czasami autorzy stron podr\u00c4cznika zast\u00c4puj\u00c4 \u2018.SH NAZWA\u2019 przez \u2018.SH M\u00c3JPROGRAM\u2019, co powoduje, \u00c5\u00bce mandb<\/b> nie potrafi odnale\u00c5\u00ba\u00c4 potrzebnych informacji. Czasami autorzy umieszczaj\u00c4 wprawdzie sekcj\u00c4 NAZWA, ale zawieraj\u00c4 w niej dowolny tekst zamiast u\u00c5\u00bcywa\u00c4 \u2018nazwa \u2212 opis\u2019. Jednak\u00c5\u00bce ka\u00c5\u00bcda sk\u00c5adania przypominaj\u00c4ca powy\u00c5\u00bcsz\u00c4 powinna by\u00c4 akceptowana.<\/p>\n

ZOBACZ TAK\u00c5\u00bbE <\/a> <\/h2>\n

apropos<\/i>(1), man<\/i>(1), whatis<\/i>(1), mandb<\/i>(8)<\/p>\n

UWAGI <\/a> <\/h2>\n

lexgrog<\/b> pr\u00c3\u00b3buje przetwarza\u00c4 pliki zawieraj\u00c4ce \u00c5\u00bc\u00c4dania .so, jednak\u00c5\u00bce b\u00c4dzie zdolny to zrobi\u00c4 tylko wtedy, gdy pliki te s\u00c4 poprawnie zainstalowane w hierarchii stron podr\u00c4cznika ekranowego.<\/p>\n

AUTOR <\/a> <\/h2>\n

Autorami kodu u\u00c5\u00bcywanego przez program lexgrog<\/b> do przetwarzania stron podr\u00c4cznika s\u00c4:<\/p>\n

Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).<\/p>\n

Colin Watson napisa\u00c5 obecne wcielnie interfejsu linii polece\u00c5 i t\u00c4 stron\u00c4 podr\u00c4cznika ekranowego.<\/p>\n

B\u00c5\u00c4DY <\/a> <\/h2>\n

https:\/\/savannah.nongnu.org\/bugs\/?group=man-db<\/p>\n

T\u00c5UMACZENIE <\/a> <\/h2>\n

Wojciech Kotwica w 1999 roku przet\u00c5umaczy\u00c5 cz\u00c4\u00c5\u00c4 stron podr\u00c4cznika pakietu man-db i udost\u00c4pni\u00c5 je w ramach Projektu T\u00c5umaczenia Manuali.
Robert Luberda t\u00c5umaczenie zaktualizowa\u00c5 i uzupe\u00c5ni\u00c5 w roku 2008.<\/p>\n

\n","protected":false},"excerpt":{"rendered":"

LEXGROG NAZWA SK\u00c5ADNIA OPIS OPCJE KOD ZAKO\u00c5CZENIA PRZYK\u00c5ADY PRZETWARZANIE WHATIS ZOBACZ TAK\u00c5\u00bbE UWAGI AUTOR B\u00c5\u00c4DY T\u00c5UMACZENIE NAZWA lexgrog \u2212 przetwarza nag\u00c5\u00c3\u00b3wki stron podr\u00c4cznika ekranowego SK\u00c5ADNIA lexgrog [\u2212m|\u2212c] [\u2212dfw?V] [\u2212E kodowanie_znak\u00c3\u00b3w] plik … OPIS lexgrog jest implementacj\u00c4 w lexie tradycyjnych narz\u00c4dzi \u201czgadywanki groffa\u201d. Ze swojej linii polece\u00c5 czyta list\u00c4 plik\u00c3\u00b3w, kt\u00c3\u00b3re mog\u00c4 by\u00c4 albo \u00c5\u00bar\u00c3\u00b3d\u00c5ami stron […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[962],"tags":[964,968,2930],"class_list":["post-6396","post","type-post","status-publish","format-standard","hentry","category-1-comandos-generales","tag-964","tag-lexgrog","tag-pl"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/6396","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=6396"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/6396\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=6396"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=6396"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=6396"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}