The Debian Package debiandoc2dbxml
----------------------------

The script "debiandoc2dbxml" translates a sgml file written according 
to the debiandoc dtd to an xml file following the docbook-xml dtd
(docbook/dtd/xml/4.0/docbookx.dtd)

You need sgml2xml, part of package sp, and xsltproc, which is now a
package in itself.

The files are:
debiandoc-tidy
debiandoc2dbxml
debiandoc-xml.dtd
book.xml
split.xml
dd2xml.html
catalog
README (this file).

How to use these scripts ?

You must first "normalize" the main sgml file and every file that it loads 
(but not sgml files referenced by entities); you can do: 
debiandoc-tidy [options] file.sgml
The main option, -e, sets the coding system if needed. 
 
Then you can choose the book element with the -b option 
or the article element with the -a option.
When the main sgml file declares an internal subset of the dtd, you must
use the -s option on the command line:
"debiandoc2dbxml -b -s file.sgml" gives you "file.xml" that you can
print with jade and jadetex.

When you choose the -S option, the script creates "main.xml" and
xml files from each bookinfo, chapter and appendix.
 
Some human polishing remains to be done to get a correctly printed text.

See /usr/share/doc/debiandoc2dbxml/dd2xml.html.
See the manpages debiandoc2dbxml (1) and debiandoc-tidy (1).

Philippe Batailler 
<philippe.batailler@free.fr>, Mon,  7 Apr 2003 00:45:56 +0200
