(Formerly, we described a quite intricate hack here to convert
to SGML to XML while preserving the ISO entities. That hack
is actually what
I don't want to hear about bugs in obsolete tools (i.e. tools that are
not in the current release of docbook2X.) I'm sorry, but maintaining all
that is a lot of work that I don't have time for.
iconverror when converting documents.
You can look at the partial man or Texinfo output — the offending
Unicode character should be near the point that the output is
interrupted. Since you probably wanted that Unicode character
to be there, the way you want to fix this error is to add
a translation for that Unicode character to the
utf8trans character map.
Then use the
--utf8trans-map option to the Perl
docbook2X tools to use your custom character map.
Alternatively, if you want to close your eyes to the utterly broken
Unicode handling in groff and Texinfo, just use the
Note that the UTF-8 output is unlikely to display correctly everywhere.
Also, if you look at native Info pages, you will see there is a certain
structure, that your DocBook document may not adhere to. There is
really no fix for this. It is possible, though, to give rendering
hints to the Texinfo stylesheet in your DocBook source, like this this
manual does. Unfortunately these are not yet documented in a prominent place.
If you use the Perl wrapper scripts provided with docbook2X,
you only need to “install” the XSLT processors (i.e. for Java, copying
the *.jar files to
/usr/local/share/java), and you don't
need to do anything else.
If your customizations can be generally useful, I would like to hear about it.
If you don't want to muck with XSLT, you can still tell me what sort
of features you want. Maybe other users want them too.
For example, if you want to convert a document in the W3C
spec DTD to Texinfo, you can write a XSLT stylesheet that outputs a
document conformant to the Texi-XML, and run that through
to get your Texinfo pages. Writing the said XSLT
stylesheet should not be any more difficult than if you were
to write a stylesheet for HTML output, in fact probably even easier.
If you want, on the other hand, to get troff output but
using a different macro set, you will have to rewrite both the
stylesheets and the post-processor (performing the function of
db2x_manxml but with a different macro set).
In this case some of the code in
db2x_manxml may be reused, and you
can certainly reuse
utf8trans and the provided roff character maps.