docbook2texi-spec.pl - convert DocBook Booksto Texinfo
documents
SYNOPSIS
sgmlspl docbook2man-spec.pl
nsgmls [ sgml document] | sgmlspl docbook2texi-spec.pl [
basename]
DESCRIPTION
docbook2texi is a sgmlspl spec file that produces GNU Tex
info documents from DocBook documents.
The program reads ESIS produced by nsgmls (or other SGML
parsers) from standard input. Currently the document ele
ment 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 con
tains all the nodes in the document and their immediate
'child' nodes. As node processing always require forward
references, docbook2texi must be run twice for each docu
ment: the first time to build the references, and the sec
ond to actually generate a valid document.
REQUIREMENTS
The SGMLSpm package from CPAN. This package includes the
sgmlspl script that is also needed.
LIMITATIONS
Trying docbook2man on non-DocBook or non-conformant SGML
results in undefined behavior. :-)
This program is a slow, dodgy Perl script.
This program does not come close to supporting all the
possible markup in DocBook, and may produce wrong output
in some cases with supported markup.
TO DO
· How the hell do you represent a backslash (\) in Tex
info!!@? I've tried \\ but TeX complains about it.
· Fix breakages found in the test documents.
· Add new element handling and fix existing handling. Be
robust.
· Make it faster. I think most of the speed problems so
and/or get input directly from SP.
· There are some dependencies on elements occurring when
they are actually optional (according to the DTD). We
need to fix that (preferably) or prominently state the
requirements.
· Allow other more common document elements.
· Separate out node referencing to a separate script. Not
only would it make it faster/easier to maintain because
it's separate from the main code, but also I would like
it to evolve into an automatic DocBook ToC generator.
COPYRIGHT
Copyright (C) 1998-1999 Steve Cheng <steve@ggi-pro
ject.org>
This program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation;
either version 2, or (at your option) any later version.
You should have received a copy of the GNU General Public
License along with this program; see the file COPYING. If
not, please write to the Free Software Foundation, 675
Mass Ave, Cambridge, MA 02139, USA.
Man(1) output converted with
man2html