lexgrog - Online di Cloud

PROGRAM:

NAMA

lexgrog - mengurai informasi header di halaman manual

RINGKASAN

lexgrog [-m|-c] [-dfw?V] [-E encoding] fillet ...

DESKRIPSI

lexgrog adalah implementasi dari utilitas "tebakan kasar" tradisional di lex. Bunyinya
daftar file pada baris perintahnya sebagai file sumber halaman manual atau diformat sebelumnya
halaman "kucing", dan menampilkan nama dan deskripsi mereka seperti yang digunakan oleh tepat dan apa yang, yang
daftar filter pra-pemrosesan yang diperlukan oleh halaman manual sebelum diteruskan ke tidak or
troff, atau keduanya.

Jika inputnya diformat dengan buruk, lexgrog akan mencetak "parse failed"; ini mungkin berguna untuk
program eksternal yang perlu memeriksa halaman manual untuk kebenarannya. Jika salah satu dari lexgrogmasukan
file adalah "-", itu akan membaca dari input standar; jika ada file input yang dikompres, a
versi dekompresi akan dibaca secara otomatis.

PILIHAN

-d, --debug
Cetak informasi debug.

-m, --pria
Parsing input sebagai file sumber halaman manual. Ini adalah default jika tidak ada --pria maupun
--kucing diberikan.

-c, --kucing
Parsing input sebagai halaman manual yang telah diformat sebelumnya (“halaman kucing”). --pria dan --kucing mungkin tidak
diberikan secara bersamaan.

-w, --apa yang
Tampilkan nama dan deskripsi dari header halaman manual, seperti yang digunakan oleh tepat dan
apa yang. Ini adalah default jika tidak ada --apa yang maupun --filter diberikan.

-f, --filter
Tampilkan daftar filter yang diperlukan untuk memproses halaman manual sebelum memformat
dengan tidak or troff.

-E encoding, --pengkodean encoding
Ganti set karakter yang ditebak untuk halaman tersebut encoding.

-?, --membantu
Cetak pesan bantuan dan keluar.

--penggunaan
Cetak pesan penggunaan singkat dan keluar.

-V, --Versi: kapan
Tampilkan informasi versi.

EXIT STATUS

0 Eksekusi program sukses.

1 Kesalahan penggunaan.

2 lexgrog gagal mengurai satu atau lebih file inputnya.

CONTOH

$ lexgrog pria.1
man.1: "man - antarmuka ke manual referensi on-line"
$lexgrog-fw man.1
man.1 (t): "man - antarmuka ke manual referensi online"
$ lexgrog -c apa.cat1
whatis.cat1: "whatis - menampilkan deskripsi halaman manual"
$ lexgrog rusak.1
rusak.1: penguraian gagal

APA YANG PENGuraian

mandb (yang menggunakan kode yang sama dengan lexgrog) menguraikan NAMA bagian di atas masing-masing
halaman manual mencari nama dan deskripsi fitur yang didokumentasikan di masing-masing. Ketika
parser cukup toleran, karena harus mengatasi sejumlah bentuk berbeda yang telah
historis telah digunakan, kadang-kadang mungkin gagal untuk mengekstrak informasi yang diperlukan.

Saat menggunakan tradisional pria set makro, benar NAMA bagian terlihat seperti
ini:

.SH NAMA
foo \- program untuk melakukan sesuatu

Beberapa pager manual memerlukan '\-' persis seperti yang ditunjukkan; mandb lebih toleran, tapi
untuk kompatibilitas dengan sistem lain, tetap merupakan ide bagus untuk mempertahankan
garis miring terbalik.

Di sisi kiri, mungkin ada beberapa nama, dipisahkan dengan koma. Nama yang mengandung
spasi akan diabaikan untuk menghindari perilaku patologis pada bentuk-bentuk buruk tertentu NAMA
bagian. Teks di sisi kanan adalah bentuk bebas, dan mungkin tersebar di beberapa
garis. Jika beberapa fitur dengan deskripsi yang berbeda didokumentasikan di tempat yang sama
halaman manual, maka formulir berikut digunakan:

.SH NAMA
foo, bar \- program untuk melakukan sesuatu
. Br
baz \- program untuk tidak melakukan apa-apa

(Makro yang memulai paragraf baru, seperti .PP, dapat digunakan sebagai pengganti makro jeda
.br.)

Saat menggunakan turunan BSD mdoc set makro, benar NAMA bagian terlihat seperti
ini:

.sh NAMA
.Nm fo
.Nd program untuk melakukan sesuatu

Ada beberapa alasan umum mengapa parsing whatis gagal. Terkadang penulis manual
halaman ganti '.SH NAME' dengan '.SH MYPROGRAM', dan kemudian mandb tidak dapat menemukan bagian dari
yang untuk mengekstrak informasi yang dibutuhkan. Terkadang penulis menyertakan bagian NAMA, tetapi
letakkan teks bentuk bebas di sana daripada 'nama \- deskripsi'. Namun, sintaks apa pun
menyerupai di atas harus diterima.

Gunakan lexgrog online menggunakan layanan onworks.net