man-pages/id/man1/lexgrog.1.html
2021-03-31 01:06:50 +01:00

256 lines
7.3 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: Penggunaan halaman buku panduan (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">&nbsp;</A>
<H2>NAMA</H2>
lexgrog - ambil kepala informasi dalam halaman buku panduan
<A NAME="lbAC">&nbsp;</A>
<H2>RINGKASAN</H2>
<B>lexgrog</B> [<B>-m</B>|<B>-c</B>] [<B>-fhw?V</B>] [<B>-E</B> <I>pengkodean</I>]
<I>berkas</I> ...
<A NAME="lbAD">&nbsp;</A>
<H2>DESKRIPSI</H2>
<B>lexgrog</B> adalah sebuah implementasi dari aplikasi tradisional "groff
guess" dalam <B>lex</B>. Ini membaca daftar dari berkas dalam baris perintah
baik berkas sumber halaman buku panduan atau preformatted "cat"
pages, dan menampilkan nama dan deskripsinya seperti yang digunakan oleh
<B>apropos</B> dan <B>whatis</B>, daftar dari saringan pemrosesan dibutuhkan oleh
halaman buku panduan sebelum ini dilewatkan ke <B>nroff</B> atau <B>troff</B>, atau
keduanya.
<P>
Jika masukannya terformat buruk, <B>lexgrog</B> akan menampilkan "parse
failed"; ini mungkin berguna untuk program eksternal yang butuh
pemeriksaan halaman buku panduan untuk pembenaran. Jika satu dari <B>lexgrog</B>
berkas masukan adalah "-", ini akan dibaca dari standar masukan; jika
berkas masukan apapun dikompress, sebuah versi tidak terkompress akan dibaca
secara otomatis.
<A NAME="lbAE">&nbsp;</A>
<H2>PILIHAN</H2>
<DL COMPACT>
<DT id="1"><B>-d</B>, <B>--debug</B>
<DD>
Tampilkan informasi penelusuran.
<DT id="2"><B>-m</B>, <B>--man</B>
<DD>
Ambil masukan sebagai berkas sumber halaman buku panduan. Ini baku jika baik
<B>--man</B> ataupun <B>--cat</B> tidak diberikan.
<DT id="3"><B>-c</B>, <B>--cat</B>
<DD>
Ambil masukan sebagai halaman buku panduan terformat ("cat
halaman"). <B>--man</B> dan <B>--cat</B> mungkin tidak diberikan secara
bersamaan.
<DT id="4"><B>-w</B>, <B>--whatis</B>
<DD>
Tampilkan nama dan deskripsi dari kepala halaman buku panduan, seperti
digunakan oleh <B>apropos</B> dan <B>whatis</B>. Ini adalah baku jika bukan
<B>--whatis</B> ataupun <B>--filters</B> diberikan.
<DT id="5"><B>-f</B>, <B>--filters</B>
<DD>
Tampilkan daftar dari penyaring yang dibutuhkan untuk preproses halaman buku
panduan sebelum memformatnya dengan <B>nroff</B> atau <B>troff</B>.
<DT id="6"><B>-E</B> <I>pengkodean</I>, <B>--encoding</B> <I>pengkodean</I><DD>
Override set karakter yang diterka untuk halaman ke <I>pengkodean</I>.
<DT id="7"><B>-?</B>, <B>--help</B>
<DD>
Tampilkan sebuah pesan bantuan dan keluar.
<DT id="8"><B>--usage</B>
<DD>
Tampilkan sebuah pesan bantuan dan keluar.
<DT id="9"><B>-V</B>, <B>--version</B>
<DD>
Tampilkan informasi versi.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>STATUS KELUAR</H2>
<DL COMPACT>
<DT id="10"><B>0</B>
<DD>
Eksekusi aplikasi sukses.
<DT id="11"><B>1</B>
<DD>
Penggunaan error.
<DT id="12"><B>2</B>
<DD>
<B>lexgrog</B> gagal untuk mengambil satu atau lebih dari berkas masukan.
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>CONTOH</H2>
<PRE>
$ lexgrog man.1
man.1: &quot;man - an interface to the system reference manuals&quot;
$ lexgrog -fw man.1
man.1 (t): &quot;man - an interface to the system reference manuals&quot;
$ lexgrog -c whatis.cat1
whatis.cat1: &quot;whatis - display manual page descriptions&quot;
$ lexgrog broken.1
broken.1: parse failed
</PRE>
<A NAME="lbAH">&nbsp;</A>
<H2>PENGAMBILAN WHATIS</H2>
<B>mandb</B> (yang menggunakan kode sama seperti <B>lexgrog</B>) mengambil <B>NAMA</B>
bagian di puncak dari setiap halaman buku panduan mencari untuk nama dan
deskripsi dari features yang didokumentasikan. Walaupun pengambil cukup
bertoleransi, karena ini harus melingkupi dengan berbagai bentuk yang
berbeda yang telah digunakan, ini mungkin kadang kadang gagal untuk
mengekstrak informasi yang dibutuhkan.
<P>
Ketika menggunakan tradisional set makro <I>man</I>, sebuah bagian <B>NAMA</B> benar
tampak seperti ini:
<P>
<DL COMPACT><DT id="13"><DD>
<PRE>
<TT>.SH NAMA
foo \- aplikasi untuk melakukan sesuatu</TT>
</PRE>
</DL>
<P>
Beberapa halaman buku panduan membutuhkan '\-' sama seperti yang
terlihat; <B>mandb</B> yang lebih bertoleransi, tetapi untuk kompabilitas
dengan sistem lain ini mungkin sebuah ide bagus untuk menjaga backslash.
<P>
Di sisi kiri, mungkin ada beberapa nama, dipisahkan dengan koma. Nama berisi
ruang kosong akan diabaikan untuk menghindari perilaku pathologikal di
beberapa bagian <B>NAMA</B> yang terbentuk buruk. Di sisi kanan mempunyai bentuk
bebas, dan mungkin dipisahkan oleh beberapa baris. Jika beberapa fitur
dengan beberapa deskripsi telah didokumentasikan dalam halaman buku panduan
yang sama, bentuk berikut sebaiknya digunakan:
<P>
<DL COMPACT><DT id="14"><DD>
<PRE>
<TT>.SH NAMA
foo, bar \- aplikasi untuk melakukan sesuatu
.br
baz \- aplikasi tidak melakukan apapun</TT>
</PRE>
</DL>
<P>
(Sebuah makro yang memulai sebuah paragraph baru, seperti <TT>.PP</TT>, dapat
digunakan daripada makro break <TT>.br</TT>.)
<P>
Ketika menggunakan set makro turunan BSD <I>mdoc</I>, sebuah bagian <B>NAMA</B> yang
benar terlihat seperti ini:
<P>
<DL COMPACT><DT id="15"><DD>
<PRE>
<TT>.Sh NAMA
.Nm foo
.Nd aplikasi untuk melakukan sesuatu</TT>
</PRE>
</DL>
<P>
Ada beberapa sebab umum kenapa pengambilan whatis gagal. Kadang kadang
pengarang dari halaman buku panduan mengganti '.SH NAMA' dengan
'.SH APLIKASIKU', dan kemudian <B>mandb</B> tidak dapat menemukan bagian
dari itu untuk mengekstrak informasi yang dibutuhkan. Kadang kala pengarang
memasukan sebuah bagian NAMA, tetapi menempatkan teks bebas disana daripada
'nama \- deskripsi'. Intinya, sintaks apapun yang menyerupai diatas
seharusnya diterima.
<A NAME="lbAI">&nbsp;</A>
<H2>LIHAT JUGA</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">&nbsp;</A>
<H2>CATATAN</H2>
<B>lexgrog</B> mencoba mengambil berkas berisi .so yang diminta, tetapi hanya
dapat melakukan itu dengan benar jika berkas secara benar terpasang di
susunan halaman buku panduan.
<A NAME="lbAK">&nbsp;</A>
<H2>PENGARANG</H2>
Kode digunakan oleh <B>lexgrog</B> untuk memindai halaman buku panduan ditulis
oleh:
<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>
Colin Watson menulis implementasi antar-muka dari baris perintah sekarang,
dan juga halaman buku panduan ini.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="16"><A HREF="#lbAB">NAMA</A><DD>
<DT id="17"><A HREF="#lbAC">RINGKASAN</A><DD>
<DT id="18"><A HREF="#lbAD">DESKRIPSI</A><DD>
<DT id="19"><A HREF="#lbAE">PILIHAN</A><DD>
<DT id="20"><A HREF="#lbAF">STATUS KELUAR</A><DD>
<DT id="21"><A HREF="#lbAG">CONTOH</A><DD>
<DT id="22"><A HREF="#lbAH">PENGAMBILAN WHATIS</A><DD>
<DT id="23"><A HREF="#lbAI">LIHAT JUGA</A><DD>
<DT id="24"><A HREF="#lbAJ">CATATAN</A><DD>
<DT id="25"><A HREF="#lbAK">PENGARANG</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:03 GMT, March 31, 2021
</BODY>
</HTML>