Ini ialah arahan lexgrog yang boleh dijalankan dalam penyedia pengehosan percuma OnWorks menggunakan salah satu daripada berbilang stesen kerja dalam talian percuma kami seperti Ubuntu Online, Fedora Online, emulator dalam talian Windows atau emulator dalam talian MAC OS.
JADUAL:
NAMA
lexgrog - menghuraikan maklumat pengepala dalam halaman manual
SINOPSIS
lexgrog [-m|-c] [-dfw?V] [-E pengekodan] fail ...
DESCRIPTION
lexgrog ialah pelaksanaan utiliti tradisional "tekaan groff" dalam lex. Ia berbunyi
senarai fail pada baris arahannya sama ada sebagai fail sumber halaman manual atau dipraformat
halaman "kucing", dan memaparkan nama dan perihalannya seperti yang digunakan oleh sesuai and apa, yang
senarai penapis prapemprosesan yang diperlukan oleh halaman manual sebelum ia dihantar ke nroff or
troff, atau kedua-duanya.
Jika inputnya diformat dengan teruk, lexgrog akan mencetak "penghuraian gagal"; ini mungkin berguna untuk
program luaran yang perlu menyemak halaman manual untuk memastikan ketepatannya. Jika salah satu daripada lexgroginput
fail ialah "-", ia akan dibaca daripada input standard; jika mana-mana fail input dimampatkan, a
versi nyahmampat akan dibaca secara automatik.
PILIHAN
-d, --nyahpepijat
Cetak maklumat penyahpepijatan.
-m, --lelaki
Menghuraikan input sebagai fail sumber halaman manusia. Ini adalah lalai jika tidak --lelaki tidak
--kucing diberikan.
-c, --kucing
Menghuraikan input sebagai halaman manusia yang telah diformatkan ("halaman kucing"). --lelaki and --kucing mungkin tidak
diberikan serentak.
-w, --apa
Paparkan nama dan penerangan daripada pengepala halaman manusia, seperti yang digunakan oleh sesuai and
apa. Ini adalah lalai jika tidak --apa tidak --penapis diberikan.
-f, --penapis
Paparkan senarai penapis yang diperlukan untuk mempraproses halaman manual sebelum memformat
bersama nroff or troff.
-E pengekodan, --pengekodan pengekodan
Gantikan set aksara yang diteka untuk halaman itu pengekodan.
-?, - membantu
Cetak mesej bantuan dan keluar.
--penggunaan
Cetak mesej penggunaan ringkas dan keluar.
-V, --versi
Paparkan maklumat versi.
EXIT STATUS
0 Perlaksanaan program yang berjaya.
1 Ralat penggunaan.
2 lexgrog gagal menghuraikan satu atau lebih fail inputnya.
CONTOH
$lexgrog man.1
man.1: "man - antara muka kepada manual rujukan dalam talian"
$ lexgrog -fw man.1
man.1 (t): "man - antara muka kepada manual rujukan dalam talian"
$ lexgrog -c whatis.cat1
whatis.cat1: "whatis - paparkan penerangan halaman manual"
$ lexgrog rosak.1
patah.1: penghuraian gagal
APA PARSING
mandb (yang menggunakan kod yang sama seperti lexgrog) menghuraikan NAMA bahagian di bahagian atas setiap satu
halaman manual mencari nama dan perihalan ciri yang didokumenkan dalam setiap satu. manakala
penghurai agak bertolak ansur, kerana ia perlu menghadapi beberapa bentuk berbeza yang ada
dari segi sejarah telah digunakan, kadangkala ia mungkin gagal untuk mengekstrak maklumat yang diperlukan.
Apabila menggunakan tradisional lelaki set makro, yang betul NAMA bahagian kelihatan seperti
ini:
.SH NAMA
foo \- program untuk melakukan sesuatu
Sesetengah alat kelui manual memerlukan '\-' tepat seperti yang ditunjukkan; mandb adalah lebih bertolak ansur, tetapi
untuk keserasian dengan sistem lain adalah idea yang baik untuk mengekalkan
garis miring ke belakang.
Di sebelah kiri, mungkin terdapat beberapa nama, dipisahkan dengan koma. Nama yang mengandungi
ruang kosong akan diabaikan untuk mengelakkan tingkah laku patologi pada bentuk yang tidak betul NAMA
bahagian. Teks di sebelah kanan adalah dalam bentuk bebas, dan mungkin tersebar dalam berbilang
garisan. Jika beberapa ciri dengan huraian berbeza sedang didokumenkan dalam satu
halaman manual, borang berikut digunakan:
.SH NAMA
foo, bar \- program untuk melakukan sesuatu
.br
baz \- program untuk melakukan apa-apa
(Makro yang memulakan perenggan baharu, seperti .PP, boleh digunakan dan bukannya makro pecah
.br.)
Apabila menggunakan terbitan BSD mdoc set makro, yang betul NAMA bahagian kelihatan seperti
ini:
.Sh NAMA
.Nm foo
.Nd program untuk melakukan sesuatu
Terdapat beberapa sebab biasa mengapa penghuraian whatis gagal. Kadang-kadang pengarang manual
halaman menggantikan '.SH NAME' dengan '.SH MYPROGRAM', dan kemudian mandb tidak dapat mencari bahagian daripada
untuk mengekstrak maklumat yang diperlukan. Kadangkala pengarang menyertakan bahagian NAMA, tetapi
letakkan teks bentuk bebas di sana dan bukannya 'nama \- perihalan'. Walau bagaimanapun, sebarang sintaks
menyerupai di atas harus diterima.
Gunakan lexgrog dalam talian menggunakan perkhidmatan onworks.net
