manlifter - Online di Cloud

PROGRAM:

NAMA

manlifter - skrip konversi massal dan test harness untuk doclifter

RINGKASAN

pengangkat barang [-D Option] [-e] [-f daftar file] [-Hai mandir] [-m] [-M] [-o diluar]
[-P patch-direktori] [-P] [-q] [-v] [-s bagian] [-X mengecualikan] nama...

pengangkat barang [-S]

DESKRIPSI

pengangkat barang adalah skrip yang mengurutkan dokter angkat kaki(1) untuk mengonversi seluruh pohon halaman manual menjadi
XML-Docbook, opsional juga menghasilkan HTML dari XML. Kegunaan lain adalah sebagai
alat uji siksaan bagi doclifter; itu mencatat kesalahan ke output standar dan mengumpulkan pengaturan waktu.

Dipanggil tanpa argumen file apa pun, manlifter mencoba mengonversi semua halaman manual yang memenuhi syarat
diinstal pada sistem, menempatkan file xml yang dihasilkan di bawah xmlman di saat ini
direktori. Setiap halaman foo.N yang berhasil diterjemahkan disalin ke manN/foo.xml di bawah
direktori keluaran, terlepas dari dari mana direktori sumber itu berasal.

Halaman manual dianggap tidak memenuhi syarat untuk konversi batch jika berisi teks yang menunjukkan
itu telah dihasilkan dari master DocBook dari dari Doxygen.

Untuk setiap file sumber yang diperiksa, jika file tujuan ada dan lebih baru dari
sumber, konversi dilewati; dengan demikian, berjalan inkremental dari pengangkat barang melakukan pekerjaan paling sedikit
diperlukan untuk menjaga agar pohon XML target tetap mutakhir. Demikian juga, dalam mode -h file HTML turunan adalah
hanya dibuat bila diperlukan.

Halaman rintisan yang hanya .begitu pengalihan diterjemahkan ke symlink yang sesuai dari XML
file (dan, dengan -h, file HTML).

pengangkat barang juga dapat dipanggil dengan argumen file tunggal, yang ditafsirkan sebagai batang
nama halaman manual potensial. pengangkat barang kemudian mencari semua bagian manual yang dipilih untuk
halaman yang cocok dan mencoba mengonversinya. Dalam hal ini, salinan halaman manual dan
versi yang dikonversi segera dijatuhkan di bawah direktori keluaran, dengan nama
foobar.man dan foobar.man.xml, masing-masing. Mode ini biasanya hanya menarik saja
untuk dokter angkat kaki pengembang untuk men-debug program itu.

Dalam salah satu kasus di atas, pengangkat barang akan membuka kompresi file jika memiliki .gz, .bz2 atau
.Z akhiran pada nama.

Opsinya adalah sebagai berikut:

-d
Berikan argumen string ke setiap panggilan doclifter sebagai opsi. Setiap token yang dipisahkan oleh ruang
dalam string menjadi argumen terpisah dalam panggilan.

-e
Jalankan dalam mode log-filter (terutama yang menarik untuk dokter angkat kaki pengembang). Dalam mode ini,
pengangkat barang membaca log pengujian dari input standar dan memfilternya dengan cara yang bergantung pada
opsi -f dan -q. Jika tidak satu pun dari ini diberikan, pesan dari proses yang berhasil adalah
dilucuti dan hanya kesalahan yang diteruskan ke keluaran standar.

-f
Biasanya, jalankan doclifter pada file yang diberi nama oleh setiap baris dalam file argumen. Di dalam
mode filter kesalahan, argumennya malah ditafsirkan sebagai pemfilteran reguler
ekspresi.

-h
Juga hasilkan terjemahan HTML ke dalam direktori keluaran. markup referensi cite DocBook
diubah menjadi hyperlink di direktori, dan daftar konten dibuat untuk
indeks.html.

-I
Tentukan akar pohon halaman manual. Secara default ini adalah /usr/share/man.

-m
Buat tambalan untuk memperbaiki halaman terakhir yang diambil. Itu disalin, editor dipanggil
salinan (menggunakan variabel lingkungan $ EDITOR), lalu diff(1) dipanggil untuk menjatuhkan
patch di direktori prepatch. Gagal dengan kesalahan jika tambalan seperti itu sudah
menyajikan.

-M
Angkat file yang ditentukan, lalu lakukan yang setara dengan opsi -m.

-o
Setel direktori keluaran di mana terjemahan XML-DocBook akan dijatuhkan. Oleh
default ini adalah xmlman di bawah direktori saat ini dalam mode batch, atau saat ini
direktori sebaliknya.

-p
Menafsirkan argumen sebagai nama direktori patch (nama default adalah prepatch
di bawah direktori saat ini). Setiap file bernama foo.N.patch ditafsirkan sebagai tambalan untuk
diterapkan ke halaman manual foo(N) sebelum doclifter menerjemahkannya.

-P
Aktifkan pembuatan profil menggunakan modul jagoan Python; ini hanya berguna untuk penyetelan
doclifter sehingga berjalan lebih cepat. Data mentah ditulis ke manlifter.prof, dan dicerna
laporan ditambahkan ke log pada output standar. Peringatan: file data mentah dapat
menjadi besar, dan pascapemrosesan untuk pembuatan laporan dapat memakan waktu selama
pemrosesan aktual (atau lebih lama!).

-q
Biasanya, berikan opsi -q (tenang) ke setiap panggilan doclifter. Dalam mode filter kesalahan,
mengembalikan daftar file yang terjemahannya gagal.

-v
Berikan opsi -v (verbose) ke setiap panggilan doclifter. Opsi ini dapat diulang untuk
meningkatkan tingkat verbositas.

-s
Tentukan bagian yang akan dipindai. Gunakan ini dengan argumen; seharusnya tidak perlu ketika
melakukan konversi dari seluruh pohon.

-S
Kompilasi statistik kesalahan dari a pengangkat barang logfile disajikan pada input standar. Ini
pilihan akan menarik terutama untuk dokter angkat kaki pengembang.

-X
Dalam mode batch, kecualikan halaman yang tercantum dalam file argumen. Dimaksudkan untuk digunakan untuk halaman
yang dikenal baik dan membutuhkan waktu yang sangat lama untuk diangkat, untuk menebang
waktu untuk uji coba. (Sebagian besar halaman terangkat dalam waktu kurang dari setengah detik, tetapi beberapa dapat mengambil
15 menit atau lebih.)

pengangkat barang memancarkan file log ke output standar. File dimulai dengan garis stempel waktu dan a
baris kosong, dan diakhiri dengan baris yang memberikan run time dan berbagai statistik menarik.
Di antara ini adalah bait, dipisahkan oleh baris kosong, satu untuk setiap file di mana dokter angkat kaki
dijalankan.

Baris pertama setiap bait dimulai dengan "!", diikuti dengan nama jalur sumbernya
pager manual, diikuti oleh "=" dan status pengembalian doclifter dijalankan pada file itu.
Setelah itu adalah spasi dan dokter angkat kakiruntime dalam hitungan detik.

Baris awal ini dapat diikuti oleh pesan informasi dan keluaran kesalahan dari
lari doclifter.

pengangkat barang harus menemukan salinan dokter angkat kaki baik di direktori saat ini atau salah satu dari
direktori perintah di Anda PATH untuk menjalankan.

Gunakan manlifter online menggunakan layanan onworks.net