docbook2man-spec.pl - Online di Cloud

PROGRAM:

NAMA

docbook2man-spec.pl - mengonversi DocBook RefEntries ke halaman manual

RINGKASAN

sgmlspl docbook2man-spec.pl

nsgml [ sgml dokumen ]| sgmlspl docbook2man-spec.pl

DESKRIPSI

docbook2man adalah file spesifikasi sgmlspl yang menghasilkan halaman manual (menggunakan makro -man) dari
Markup DocBook RefEntry.

Program membaca ESIS yang dihasilkan oleh nsgmls (atau parser SGML lainnya) dari input standar.
Markup yang tidak ditemukan di RefEntry dibuang.

Outputnya, halaman manual yang dikonversi, ditulis ke direktori saat ini. Jika RefMeta
informasi tidak ditentukan dalam RefEntry, maka halaman manual akan ditulis ke standar
output.

File halaman manual.link juga akan dibuat, yang berisi alias dari halaman manual
dihasilkan. File ini dalam format:

<manusia halaman> <alias
halaman manual>

Grafik halaman manual.refs file melacak referensi XRef. Perhatikan bahwa jika dokumen input memiliki
referensi maju apa pun, maka docbook2man mungkin harus dipanggil dua kali (pertama kali
memperbarui halaman manual.refs) untuk menyelesaikannya.

PERSYARATAN

Paket SGMLSpm dari CPAN. Paket ini termasuk skrip sgmlspl yang juga
dibutuhkan.

PEMBATASAN

mencoba docbook2man pada non-DocBook atau SGML yang tidak sesuai menghasilkan perilaku yang tidak terdefinisi.
:-)

Program ini adalah skrip Perl yang lambat dan cerdik.

Program ini tidak mendukung semua kemungkinan markup di DocBook, dan mungkin
menghasilkan keluaran yang salah dalam beberapa kasus dengan markup yang didukung.

UNTUK DO

Hal-hal yang jelas:

· Memperbaiki docbook2man kerusakan yang ditemukan dalam dokumen pengujian, terutama aneh.sgml.

· Tambahkan penanganan elemen baru dan perbaiki penanganan yang ada. Jadilah kuat.

· Menghasilkan output man terbersih dan terbaca sebanyak mungkin (tidak seperti beberapa konverter lainnya).
Ikuti Linux pria(7) konvensi. Karena konversi ke halaman manual biasanya tidak dilakukan dengan baik
seringkali, lebih baik menjadi lebih lambat/lebih rumit daripada menghasilkan keluaran yang salah. Juga jika
seseorang ingin berhenti menggunakan DocBook untuk alasan apa pun, halaman manual yang terakhir dikonversi
kemudian dapat dipertahankan secara manual.

· Membuatnya lebih cepat. Saya pikir sebagian besar masalah kecepatan sejauh ini adalah dengan menguraikan ESIS. Menulis kembali
SGMLS.pm dengan C dan/atau dapatkan masukan langsung dari SP.

· Mendukung bahasa lain (manusia). Tapi apa yang harus dilakukan dengan rangkaian karakter non-ASCII? SGMLSpm
tidak melaporkannya dan roff tidak menggertak mereka. [Komentar: teks setelah daftar terlampir
(dan blok SS) akan merusak docbook2man] Jika kita melakukan ini, lebih banyak orang dapat menggunakan DocBook.

HAK CIPTA

Hak Cipta (C) 1998-1999 Steve Cheng[email dilindungi]>

Program ini adalah perangkat lunak gratis; Anda dapat mendistribusikan ulang dan/atau memodifikasinya di bawah ketentuan
Lisensi Publik Umum GNU sebagaimana diterbitkan oleh Free Software Foundation; salah satu
versi 2, atau (sesuai pilihan Anda) versi yang lebih baru.

Anda seharusnya telah menerima salinan GNU General Public License bersama dengan program ini;
lihat filenya PENYALINAN. Jika tidak, silakan menulis ke Free Software Foundation, 675 Mass Ave,
Cambridge, MA 02139, AS.

29 Oktober 2012 DOCBOOK2MAN-SPEC.PL(1)

Gunakan docbook2man-spec.pl online menggunakan layanan onworks.net