docbook2man-spec.pl - Online în cloud

PROGRAM:

NUME

docbook2man-spec.pl - convertiți DocBook RefEntries în pagini de manual

REZUMAT

sgmlspl docbook2man-spec.pl

nsgmls [ sgml document ]| sgmlspl docbook2man-spec.pl

DESCRIERE

docbook2man este un fișier de specificații sgmlspl care a produs pagini de manual (folosind macrocomenzile -man) din
Markup DocBook RefEntry.

Programul citește ESIS produs de nsgmls (sau alți analizatori SGML) din intrarea standard.
Markup negăsit în RefEntry este eliminat.

Ieșirea sa, paginile de manual convertite, sunt scrise în directorul curent. Dacă RefMeta
informațiile nu sunt specificate într-o RefEntry, atunci pagina de manual va fi scrisă la standard
ieșire.

Fișierul manpage.links va fi de asemenea creat, care conține orice alias al paginilor de manual
generate. Acest fișier este în formatul:

<man pagina> <alias
pagina de manual>

pagina de manual.ref fișierul ține evidența referințelor XRef. Rețineți că dacă documentul de intrare are
orice referințe înainte, atunci docbook2man poate fi necesar să fie invocat de două ori (prima dată
actualizarea pagina de manual.ref) pentru a le rezolva.

CERINȚE

Pachetul SGMLSpm de la CPAN. Acest pachet include și scriptul sgmlspl
Necesar.

LIMITAREA

încercat docbook2man pe SGML non-DocBook sau neconform are ca rezultat un comportament nedefinit.
:-)

Acest program este un script Perl lent și dus.

Acest program nu este aproape de a accepta toate posibilele markupuri în DocBook și poate
produce rezultate greșite în unele cazuri cu marcaj acceptat.

LA DO

Lucruri evidente:

· Remediere docbook2man spargerile constatate în documentele de testare, în special ciudat.sgml.

· Adăugați un nou element de manipulare și reparați manipularea existentă. Fii robust.

· Produceți o ieșire de om cât mai curată și lizibilă posibil (spre deosebire de alte convertoare).
Urmați Linux om(7) convenție. Deoarece conversia în paginile de manual nu se face, de obicei, prea mult
de multe ori, este mai bine să fii mai lent/mai complicat decât să produci rezultate greșite. De asemenea, dacă
cineva vrea să renunțe la utilizarea DocBook din orice motiv, ultimele pagini de manual convertite
apoi poate fi întreținut manual.

· Fă-l mai rapid. Cred că majoritatea problemelor de viteză de până acum sunt legate de analizarea ESIS. Rescrie
SGMLS.pm cu C și/sau obțineți intrare direct de la SP.

· Sprijină alte limbi (umane). Dar ce să faci cu seturile de caractere non-ASCII? SGMLSpm
nu le raportează şi roff nu le grok. [Comentariu: text după listele anexate
(și blocurile SS) vor rupe docbook2man] Dacă facem asta, mai mulți oameni pot folosi DocBook.

DREPTURI DE AUTOR

Drepturi de autor (C) 1998-1999 Steve Cheng[e-mail protejat]>

Acest program este software gratuit; îl puteți redistribui și/sau modifica în conformitate cu termenii
Licența publică generală GNU publicată de Free Software Foundation; fie
versiunea 2 sau (la alegerea dvs.) orice versiune ulterioară.

Ar fi trebuit să primiți o copie a licenței publice generale GNU împreună cu acest program;
vezi fisierul COPIEREA. Dacă nu, vă rugăm să scrieți la Free Software Foundation, 675 Mass Ave,
Cambridge, MA 02139, SUA.

29 octombrie 2012 DOCBOOK2MAN-SPEC.PL(1)

Utilizați docbook2man-spec.pl online folosind serviciile onworks.net