docbook2texi-spec.pl

Name

docbook2texi-spec.pl --  convert DocBook documents to Texinfo

Synopsis

sgmlspl {docbook2man-spec.pl}

nsgmls [sgml document]
| sgmlspl docbook2texi-spec.pl [basename]

Description

Warning

This program is not maintained, severely broken, and is obsoleted by docbook2texixml.

docbook2texi-spec is a sgmlspl spec file that produces GNU Texinfo documents from DocBook documents.

The program reads ESIS produced by nsgmls (or other SGML parsers) from standard input. Currently the document element must be book, otherwise the results are undefined.

Its output, the converted Texinfo document, is written to standard output.

The file basename.refs will also be created, which contains all the nodes in the document and their immediate 'child' nodes. As node processing always require forward references, docbook2texi-spec must be run twice for each document: the first time to build the references, and the second to actually generate a valid document.

Limitations

Always validate the input document. Although some docbook2X tools try to be resiliant against unrecognized markup, the behavior when encountering such markup is undefined.

The docbook2X tools do not support all of DocBook, or may produce wrong output or even die with markup that is claimed to be supported. These are bugs and you should nag the maintainer about them.