.\" 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. .pc "" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH LEXGROG 1 2023-01-08 2.11.2 "Помагало страничара упутства" .SH НАЗИВ lexgrog \- обрађује податке заглавља у страницама упутства .SH УВОД \fBlexgrog\fP [\|\fB\-m\fP\||\|\fB\-c\fP\|] [\|\fB\-dfw?V\fP\|] [\|\fB\-E\fP \fIкодирање\fP\|] \fIдатотека\fP \&.\|.\|. .SH ОПИС \fBлексгрог\fP је примена традиционалног помагала „groff guess“ у \fBлексу\fP. Чита списак датотека на својој линији наредби или као изворне датотеке страница упутства или као унапред обликоване „cat“ странице, и приказује њихове називе и описе као што их користе \fBapropos\fP и \fBwhatis\fP, списак пропусника предобраде које захтева страница упутства пре прослеђивања у \fBнрофф\fP или \fBтрофф\fP или у оба. .PP Ако је његов улаз лоше обликован, \fBлексгрог\fP ће исписати „parse failed“ (обрада није успела); што може бити корисно спољним програмима који треба да провере странице упутства за тачношћу. Ако једна улазна датотека \fBлексгрог\fPа јесте „\-“, читаће са стандардног улаза; ако је било која улазна датотека запакована, распаковано издање ће бити читано. .SH ОПЦИЈЕ .TP .if !'po4a'hide' .BR \-d ", " \-\-debug Исписује податке прочишћавања. .TP .if !'po4a'hide' .BR \-m ", " \-\-man Обрађује улаз као изворне датотеке страница упутства. Ово је основно ако није дато ни „\fB\-\-man\fP“ ни „\fB\-\-cat\fP“. .TP .if !'po4a'hide' .BR \-c ", " \-\-cat Обрађује улаз као предобликоване странице упутства („cat pages“). „\fB\-\-man\fP“ и „\fB\-\-cat\fP“ не могу бити дати истовремено. .TP .if !'po4a'hide' .BR \-w ", " \-\-whatis Приказује назив и опис из заглавља странице упутства, као што користе \fBapropos\fP и \fBwhatis\fP. Ово је основно ако није дато ни „\fB\-\-whatis\fP“ ни „\fB\-\-filters\fP“. .TP .if !'po4a'hide' .BR \-f ", " \-\-filters Приказује списак пропусника потребних за предобраду странице упутства пре обликовања \fBнрофф\fP\-ом или \fBтрофф\fP\-ом. .TP \fB\-E\fP \fIкодирање\fP, \fB\-\-encoding\fP \fIкодирање\fP Пребацује откривени скуп знакова за страницу на \fIкодирање\fP. .TP .if !'po4a'hide' .BR \-? ", " \-\-help Исписује поруку помоћи и излази. .TP .if !'po4a'hide' .B \-\-usage Исписује кратку поруку о коришћењу и излази. .TP .if !'po4a'hide' .BR \-V ", " \-\-version Исписује податке о издању. .SH "СТАЊЕ ИЗЛАЗА" .TP .if !'po4a'hide' .B 0 Успешно извршавање програма. .TP .if !'po4a'hide' .B 1 Грешка коришћења. .TP .if !'po4a'hide' .B 2 „\fBлексгрог\fP“ није успео да обради једну или више својих улазних датотека. .SH ПРИМЕРИ .nf $ lexgrog man.1 man.1: „man \- сучеље за упутства упута система“ $ lexgrog \-fw man.1 man.1 (t): „man \- сучеље за упутства упута система“ $ lexgrog \-c whatis.cat1 whatis.cat1: „whatis \- приказује описе страница упутства“ $ lexgrog broken.1 broken.1: обрада није успела .fi .SH "ШТА\-ЈЕ ОБРАДА" \fB%мандб%\fP (који користи исти код као и \fBлексгрог\fP) обрађује одељак \fBНАЗИВ\fP на врху сваке странице упутства тражећи називе и описе функција које су документоване у свакој. Док је обрађивач поприлично толерантан, јер мора да се бори са бројним различитим облицима који су коришћени кроз историју, може понекад и да не успе да извуче затражене податке. .PP Приликом коришћења традиционалног макро скупа \fIман\fP\-а, исправан одељак \fBНАЗИВ\fP личи на овако нешто: .PP .RS .nf \f(CW\&.SH НАЗИВ foo \e\- програм који ће да уради нешто\fP .fi .RE .PP Неки страничари упутства захтевају „\e\-“ да би били тачно као што је приказано; \fB%мандб%\fP“ је толерантнији, али због сагласности са другим системима ипак је добра идеја задржати контра косу црту. .PP На левој страни, може постојати неколико назива, раздвијених зарезима. Називи који садрже празнину биће занемарени да би се избегло патолошко понашање на одређеним лоше обликованим одељцима \fBНАЗИВ\fP. Текст на десној страни је слободан образац, и може бити раширен преко неколико редова. Ако је документовано неколико функција са различитим описима на истој страници упутства, онда се користи следећи образац: .PP .RS .nf \f(CW\&.SH НАЗИВ foo, bar \e\- програми који ће урадити нешто \&.br baz \e\- програм који неће ништа да ради\fP .fi .RE .PP (Макро који започиње нови пасус, као „\f(CW.PP\fP“, може бити коришћен уместо макроа прекида „\f(CW.br\fP“.) .PP Приликом коришћења \fIмдоц\fP макро скупа произашлог из БСД\-а, исправан одељак \fBНАЗИВ\fP личи на овако нешто: .PP .RS .nf \f(CW\&.SH НАЗИВ \&.Nm foo \&.Nd програм који ће нешто да уради\fP .fi .RE Има неколико општих разлога зашто не успе шта\-је обрада. Понекад аутори страница упутства замене „.SH НАЗИВ“ са „.SH МОЈПРОГРАМ“, и тада \fB%мандб%\fP не може да пронађе одељак из ког да извуче податке које требује. Понекад аутори укључе одељак НАЗИВ, али ту ставе текст у слободном облику уместо „name \e\- description“. Међутим, било која синтакса налик на горњу би требала бити прихваћена. .SH "ВИДЕТИ ТАКОЂЕ" .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 НАПОМЕНЕ \fBлексгрог\fP покушава да обради датотеке које садрже „.so“ захтеве, али ће бити у стању да то уради тачно само ако су датотеке исправно инсталиране у хијерархији странице упутства. .SH АУТОР Код који користи „\fBлексгрог\fP“ да прегледа ман странице је написао: .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 Колин Вотсон је написао текуће отелотворење челника линије наредби, као и ову страницу упутства. .SH ГРЕШКЕ .if !'po4a'hide' https://gitlab.com/man-db/man-db/-/issues .br .if !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man-db