manlifter - Dalam talian di Awan

JADUAL:

NAMA

manlifter - skrip penukaran massa dan abah-abah ujian untuk doclifter

SINOPSIS

pengangkat lelaki [-d pilihan] [-e] [-f fail senarai] [-h] [-I mandir] [-m] [-M] [-o luar]
[-hlm direktori tampalan] [-P] [-q] [-v] [-s seksyen] [-X tidak termasuk] nama...

pengangkat lelaki [-S]

DESCRIPTION

pengangkat lelaki ialah skrip yang berurutan pendidik(1) untuk menukar keseluruhan pepohon halaman manual kepada
XML-Docbook, secara pilihan juga menjana HTML daripada XML. Kegunaan lain ialah sebagai a
alat ujian seksaan untuk doclifter; ia mencatat ralat ke output standard dan mengumpul pemasaan.

Dipanggil tanpa sebarang hujah fail, manlifter cuba menukar semua halaman manual yang layak
dipasang pada sistem, meletakkan fail xml yang terhasil di bawah xmlman dalam semasa
direktori. Setiap halaman foo.N yang berjaya diterjemahkan disalin ke manN/foo.xml di bawah
direktori output, tidak kira dari mana direktori sumber ia datang.

Halaman manual dianggap tidak layak untuk penukaran kelompok jika ia mengandungi teks yang menunjukkan
ia telah dijana daripada tuan DocBook daripada Doxygen.

Bagi setiap fail sumber yang diperiksa, jika fail destinasi wujud dan lebih baharu daripada fail
sumber, penukaran dilangkau; oleh itu, larian tambahan pengangkat lelaki buat kerja yang paling sedikit
diperlukan untuk memastikan pokok XML sasaran dikemas kini. Begitu juga, fail HTML terbitan dalam mod -h ialah
hanya dibuat apabila perlu.

Stub halaman yang adil .so ubah hala diterjemahkan kepada pautan sym XML yang sepadan
fail (dan, dengan -h, fail HTML).

pengangkat lelaki juga boleh dipanggil dengan argumen fail tunggal, yang ditafsirkan sebagai stem
nama halaman manual yang berpotensi. pengangkat lelaki kemudian mencari semua bahagian manual yang dipilih untuk
halaman yang sepadan dan cuba menukarnya. Dalam kes ini, salinan halaman lelaki dan
versi yang ditukar digugurkan serta-merta mencelah direktori output, dengan nama
foobar.man dan foobar.man.xml, masing-masing. Mod ini biasanya hanya untuk kepentingan sahaja
kepada pendidik pembangun untuk menyahpepijat program itu.

Dalam salah satu daripada kes di atas, pengangkat lelaki akan menyahmampat fail jika ia mempunyai .gz, .bz2 atau
.Zan akhiran pada nama.

Pilihannya adalah seperti berikut:

-d
Hantarkan hujah rentetan kepada setiap panggilan doclifter sebagai pilihan. Setiap token yang dipisahkan oleh ruang
dalam rentetan menjadi hujah yang berasingan dalam panggilan.

-e
Jalankan dalam mod penapis log (terutamanya menarik minat pendidik pemaju). Dalam mod ini,
pengangkat lelaki membaca log ujian daripada input standard dan menapisnya mengikut cara yang bergantung kepada
pilihan -f dan -q. Jika kedua-duanya tidak diberikan, mesej daripada larian yang berjaya adalah
dilucutkan dan hanya ralat yang dilalui ke output standard.

-f
Biasanya, jalankan doclifter pada fail yang dinamakan oleh setiap baris dalam fail argumen. Dalam
mod penapis ralat hujah sebaliknya ditafsirkan sebagai penapisan biasa
ungkapan.

-h
Juga menjana terjemahan HTML ke dalam direktori output. Penanda citerefentry DocBook
ditukar kepada hiperpautan dalam direktori, dan penyenaraian kandungan dijana untuk
indeks.html.

-I
Tentukan punca pokok halaman manual. Secara lalai ini ialah /usr/share/man.

-m
Buat tampalan untuk membetulkan halaman terakhir yang diambil. Ia disalin, editor dipanggil
salinan (menggunakan pembolehubah persekitaran EDITOR $), dan kemudian diff(1) dipanggil untuk menggugurkan
patch dalam direktori prepatch. Gagal dengan ralat jika tampalan sedemikian sudah ada
Sekarang.

-M
Angkat fail yang ditentukan, kemudian lakukan yang setara dengan pilihan -m.

-o
Tetapkan direktori output tempat terjemahan XML-DocBook akan digugurkan. Oleh
lalai ini ialah xmlman di bawah direktori semasa dalam mod kelompok, atau semasa
direktori sebaliknya.

-p
Tafsirkan hujah sebagai nama direktori patch (nama lalai ialah prepatch
di bawah direktori semasa). Setiap fail bernama foo.N.patch ditafsirkan sebagai patch kepada
digunakan pada halaman manual foo(N) sebelum doclifter menterjemahkannya.

-P
Dayakan pemprofilan menggunakan modul hotshot Python; ini hanya berguna untuk penalaan
doclifter supaya ia berjalan lebih cepat. Data mentah ditulis kepada manlifter.prof, dan dicerna
laporan dilampirkan pada log keluaran standard. Amaran: fail data mentah boleh
menjadi besar, dan pasca pemprosesan untuk penjanaan laporan boleh mengambil masa selagi
pemprosesan sebenar (atau lebih lama!).

-q
Biasanya, hantarkan pilihan -q (tenang) kepada setiap panggilan doclifter. Dalam mod penapis ralat,
kembalikan senarai fail yang terjemahannya gagal.

-v
Hantar pilihan -v (verbose) kepada setiap panggilan doclifter. Pilihan ini boleh diulang ke
meningkatkan tahap verbositi.

-s
Tentukan bahagian untuk diimbas. Gunakan ini dengan hujah; ia sepatutnya tidak perlu apabila
melakukan penukaran keseluruhan pokok.

-S
Susun statistik ralat daripada a pengangkat lelaki fail log dibentangkan pada input standard. ini
pilihan akan menarik minat terutamanya kepada pendidik pemaju.

-X
Dalam mod kelompok kecualikan halaman yang disenaraikan dalam fail argumen. Bermaksud untuk digunakan untuk halaman
yang diketahui baik dan mengambil masa yang sangat lama untuk diangkat, untuk mengurangkan
masa untuk menjalankan ujian. (Kebanyakan halaman dinaikkan dalam masa kurang daripada setengah saat, tetapi beberapa halaman boleh mengambil masa
15 minit atau lebih lama.)

pengangkat lelaki memancarkan fail log ke output standard. Fail bermula dengan garis cap masa dan a
garisan kosong, dan berakhir dengan garisan yang memberikan masa larian dan pelbagai statistik menarik.
Di antara ini adalah rangkap, dipisahkan oleh baris kosong, satu untuk setiap fail yang mana pendidik
telah dijalankan.

Baris pertama setiap rangkap dimulakan dengan "! ", diikuti dengan nama laluan sumber
pager manual, diikuti dengan "=" dan status pengembalian doclifter dijalankan pada fail itu.
Berikutan itu adalah ruang dan pendidikmasa jalan dalam beberapa saat.

Baris awal ini mungkin diikuti oleh mesej maklumat dan output ralat
lari doclifter.

pengangkat lelaki mesti mencari salinan pendidik sama ada dalam direktori semasa atau salah satu daripada
direktori arahan dalam anda PATH untuk berlari.

Gunakan manlifter dalam talian menggunakan perkhidmatan onworks.net