250 lines
10 KiB
HTML
250 lines
10 KiB
HTML
|
||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<HTML><HEAD><TITLE>Man page of LEXGROG</TITLE>
|
||
</HEAD><BODY>
|
||
<H1>LEXGROG</H1>
|
||
Section: Помагало страничара упутства (1)<BR>Updated: 2020-02-25<BR><A HREF="#index">Index</A>
|
||
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
||
|
||
<A NAME="lbAB"> </A>
|
||
<H2>НАЗИВ</H2>
|
||
|
||
lexgrog - обрађује податке заглавља у страницама упутства
|
||
<A NAME="lbAC"> </A>
|
||
<H2>УВОД</H2>
|
||
|
||
<B>lexgrog</B> [<B>-m</B>|<B>-c</B>] [<B>-dfw?V</B>] [<B>-E</B> <I>кодирање</I>]
|
||
<I>датотека</I> ...
|
||
<A NAME="lbAD"> </A>
|
||
<H2>ОПИС</H2>
|
||
|
||
<B>лексгрог</B> је примена традиционалног помагала „groff guess“ у <B>лексу</B>.
|
||
Чита списак датотека на својој линији наредби или као изворне датотеке
|
||
страница упутства или као унапред обликоване „cat“ странице, и приказује
|
||
њихове називе и описе као што их користе <B>apropos</B> и <B>whatis</B>, списак
|
||
пропусника предобраде које захтева страница упутства пре прослеђивања у
|
||
<B>нрофф</B> или <B>трофф</B> или у оба.
|
||
<P>
|
||
|
||
Ако је његов улаз лоше обликован, <B>лексгрог</B> ће исписати „parse failed“
|
||
(обрада није успела); што може бити корисно спољним програмима који треба да
|
||
провере странице упутства за тачношћу. Ако једна улазна датотека
|
||
<B>лексгрог</B>а јесте „-“, читаће са стандардног улаза; ако је било која улазна
|
||
датотека запакована, распаковано издање ће бити читано.
|
||
<A NAME="lbAE"> </A>
|
||
<H2>ОПЦИЈЕ</H2>
|
||
|
||
<DL COMPACT>
|
||
<DT id="1"><B>-d</B>, <B>--debug</B>
|
||
|
||
|
||
<DD>
|
||
Исписује податке прочишћавања.
|
||
<DT id="2"><B>-m</B>, <B>--man</B>
|
||
|
||
|
||
<DD>
|
||
Обрађује улаз као изворне датотеке страница упутства. Ово је основно ако
|
||
није дато ни „<B>--man</B>“ ни „<B>--cat</B>“.
|
||
<DT id="3"><B>-c</B>, <B>--cat</B>
|
||
|
||
|
||
<DD>
|
||
Обрађује улаз као предобликоване странице упутства („cat pages“).
|
||
„<B>--man</B>“ и „<B>--cat</B>“ не могу бити дати истовремено.
|
||
<DT id="4"><B>-w</B>, <B>--whatis</B>
|
||
|
||
|
||
<DD>
|
||
Приказује назив и опис из заглавља странице упутства, као што користе
|
||
<B>apropos</B> и <B>whatis</B>. Ово је основно ако није дато ни „<B>--whatis</B>“ ни
|
||
„<B>--filters</B>“.
|
||
<DT id="5"><B>-f</B>, <B>--filters</B>
|
||
|
||
|
||
<DD>
|
||
Приказује списак пропусника потребних за предобраду странице упутства пре
|
||
обликовања <B>нрофф</B>-ом или <B>трофф</B>-ом.
|
||
<DT id="6"><B>-E</B> <I>кодирање</I>, <B>--encoding</B> <I>кодирање</I><DD>
|
||
Пребацује откривени скуп знакова за страницу на <I>кодирање</I>.
|
||
<DT id="7"><B>-?</B>, <B>--help</B>
|
||
|
||
|
||
<DD>
|
||
Исписује поруку помоћи и излази.
|
||
<DT id="8"><B>--usage</B>
|
||
|
||
|
||
<DD>
|
||
Исписује кратку поруку о коришћењу и излази.
|
||
<DT id="9"><B>-V</B>, <B>--version</B>
|
||
|
||
|
||
<DD>
|
||
Исписује податке о издању.
|
||
</DL>
|
||
<A NAME="lbAF"> </A>
|
||
<H2>СТАЊЕ ИЗЛАЗА</H2>
|
||
|
||
<DL COMPACT>
|
||
<DT id="10"><B>0</B>
|
||
|
||
|
||
<DD>
|
||
Успешно извршавање програма.
|
||
<DT id="11"><B>1</B>
|
||
|
||
|
||
<DD>
|
||
Грешка коришћења.
|
||
<DT id="12"><B>2</B>
|
||
|
||
|
||
<DD>
|
||
„<B>лексгрог</B>“ није успео да обради једну или више својих улазних датотека.
|
||
</DL>
|
||
<A NAME="lbAG"> </A>
|
||
<H2>ПРИМЕРИ</H2>
|
||
|
||
<PRE>
|
||
$ 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
|
||
</PRE>
|
||
|
||
<A NAME="lbAH"> </A>
|
||
<H2>ШТА-ЈЕ ОБРАДА</H2>
|
||
|
||
<B>%мандб%</B> (који користи исти код као и <B>лексгрог</B>) обрађује одељак
|
||
<B>НАЗИВ</B> на врху сваке странице упутства тражећи називе и описе функција
|
||
које су документоване у свакој. Док је обрађивач поприлично толерантан, јер
|
||
мора да се бори са бројним различитим облицима који су коришћени кроз
|
||
историју, може понекад и да не успе да извуче затражене податке.
|
||
<P>
|
||
|
||
Приликом коришћења традиционалног макро скупа <I>ман</I>-а, исправан одељак
|
||
<B>НАЗИВ</B> личи на овако нешто:
|
||
<P>
|
||
|
||
<DL COMPACT><DT id="13"><DD>
|
||
<PRE>
|
||
<TT>.SH НАЗИВ
|
||
foo \- програм који ће да уради нешто</TT>
|
||
</PRE>
|
||
|
||
</DL>
|
||
|
||
<P>
|
||
|
||
Неки страничари упутства захтевају „\-“ да би били тачно као што је
|
||
приказано; <B>%мандб%</B>“ је толерантнији, али због сагласности са другим
|
||
системима ипак је добра идеја задржати контра косу црту.
|
||
<P>
|
||
|
||
На левој страни, може постојати неколико назива, раздвијених зарезима.
|
||
Називи који садрже празнину биће занемарени да би се избегло патолошко
|
||
понашање на одређеним лоше обликованим одељцима <B>НАЗИВ</B>. Текст на десној
|
||
страни је слободан образац, и може бити раширен преко неколико редова. Ако
|
||
је документовано неколико функција са различитим описима на истој страници
|
||
упутства, онда се користи следећи образац:
|
||
<P>
|
||
|
||
<DL COMPACT><DT id="14"><DD>
|
||
<PRE>
|
||
<TT>.SH НАЗИВ
|
||
foo, bar \- програми који ће урадити нешто
|
||
.br
|
||
baz \- програм који неће ништа да ради</TT>
|
||
</PRE>
|
||
|
||
</DL>
|
||
|
||
<P>
|
||
|
||
(Макро који започиње нови пасус, као „<TT>.PP</TT>“, може бити коришћен уместо
|
||
макроа прекида „<TT>.br</TT>“.)
|
||
<P>
|
||
|
||
Приликом коришћења <I>мдоц</I> макро скупа произашлог из БСД-а, исправан одељак
|
||
<B>НАЗИВ</B> личи на овако нешто:
|
||
<P>
|
||
|
||
<DL COMPACT><DT id="15"><DD>
|
||
<PRE>
|
||
<TT>.SH НАЗИВ
|
||
.Nm foo
|
||
.Nd програм који ће нешто да уради</TT>
|
||
</PRE>
|
||
|
||
</DL>
|
||
|
||
<P>
|
||
Има неколико општих разлога зашто не успе шта-је обрада. Понекад аутори
|
||
страница упутства замене „.SH НАЗИВ“ са „.SH МОЈПРОГРАМ“, и тада <B>%мандб%</B>
|
||
не може да пронађе одељак из ког да извуче податке које требује. Понекад
|
||
аутори укључе одељак НАЗИВ, али ту ставе текст у слободном облику уместо
|
||
„name \- description“. Међутим, било која синтакса налик на горњу би
|
||
требала бити прихваћена.
|
||
<A NAME="lbAI"> </A>
|
||
<H2>ВИДЕТИ ТАКОЂЕ</H2>
|
||
|
||
<I><A HREF="/cgi-bin/man/man2html?1+apropos">apropos</A></I>(1),
|
||
|
||
|
||
<I><A HREF="/cgi-bin/man/man2html?1+man">man</A></I>(1),
|
||
|
||
|
||
<I><A HREF="/cgi-bin/man/man2html?1+whatis">whatis</A></I>(1),
|
||
|
||
|
||
<I><A HREF="/cgi-bin/man/man2html?8+mandb">mandb</A></I>(8)
|
||
|
||
|
||
<A NAME="lbAJ"> </A>
|
||
<H2>НАПОМЕНЕ</H2>
|
||
|
||
<B>лексгрог</B> покушава да обради датотеке које садрже „.so“ захтеве, али ће
|
||
бити у стању да то уради тачно само ако су датотеке исправно инсталиране у
|
||
хијерархији странице упутства.
|
||
<A NAME="lbAK"> </A>
|
||
<H2>АУТОР</H2>
|
||
|
||
Код који користи „<B>лексгрог</B>“ да прегледа ман странице је написао:
|
||
<P>
|
||
|
||
<PRE>
|
||
Wilf. (<A HREF="mailto:G.Wilford@ee.surrey.ac.uk">G.Wilford@ee.surrey.ac.uk</A>).Fabrizio Polacco (<A HREF="mailto:fpolacco@debian.org">fpolacco@debian.org</A>).Colin Watson (<A HREF="mailto:cjwatson@debian.org">cjwatson@debian.org</A>).</PRE>
|
||
|
||
<P>
|
||
|
||
Колин Вотсон је написао текуће отелотворење челника линије наредби, као и
|
||
ову страницу упутства.
|
||
<P>
|
||
|
||
<HR>
|
||
<A NAME="index"> </A><H2>Index</H2>
|
||
<DL>
|
||
<DT id="16"><A HREF="#lbAB">НАЗИВ</A><DD>
|
||
<DT id="17"><A HREF="#lbAC">УВОД</A><DD>
|
||
<DT id="18"><A HREF="#lbAD">ОПИС</A><DD>
|
||
<DT id="19"><A HREF="#lbAE">ОПЦИЈЕ</A><DD>
|
||
<DT id="20"><A HREF="#lbAF">СТАЊЕ ИЗЛАЗА</A><DD>
|
||
<DT id="21"><A HREF="#lbAG">ПРИМЕРИ</A><DD>
|
||
<DT id="22"><A HREF="#lbAH">ШТА-ЈЕ ОБРАДА</A><DD>
|
||
<DT id="23"><A HREF="#lbAI">ВИДЕТИ ТАКОЂЕ</A><DD>
|
||
<DT id="24"><A HREF="#lbAJ">НАПОМЕНЕ</A><DD>
|
||
<DT id="25"><A HREF="#lbAK">АУТОР</A><DD>
|
||
</DL>
|
||
<HR>
|
||
This document was created by
|
||
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
||
using the manual pages.<BR>
|
||
Time: 00:06:23 GMT, March 31, 2021
|
||
</BODY>
|
||
</HTML>
|