Hi Sam,
I agree with Yann and Tilly: the jade wrapper (docbook2man) won't work with
XML. In fact, docbook2man can just barely be said to work with SGML. It
relies on a fairly simple perl script, which does not institute even one
tenth of the functionality offered by the DocBook refentry subset.
I've had a good deal more luck with xslt and xsltproc. Honestly, you'll
find that even with xsltproc, the DocBook to man page XSLT has a few holes.
It won't handle tables and it chokes on nested lists. Otherwise, it works
fairly well.
Dennis Grace
Information Developer
IBM Linux Technology Center
(512) 838-3937 T/L 678-3937 cell: (512)-296-7830
If God dropped acid, would He see people?
Yann Dirson
< To: Sam Steingold <>
e.com> cc:
Subject: Re: [docbook-apps] DocBook/XML --> [tgn]roff
04/25/2003 02:02
AM
On Fri, Apr 25, 2003 at 12:12:56AM -0400, Sam Steingold wrote:
> I have a man page which I maintain in both HTML and groff formats.
> I know that groff can output HTML, but I have some href links in the
> HTML which I would rather keep.
> So I want to switch to DocBook/XML for the page and produce both HTML
> and roff out of it.
> Have anyone done that?
>
> PS. docbook2man barfs with
>
nsgmls:<URL>http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd:112:17:E:
"X20AC" is not a function name
>
nsgmls:<URL>http://www.oasis-open.org/docbook/xml/4.2/ent/iso-amsa.ent:8:19:E:
"X21B6" is not a function name
>
nsgmls:<URL>http://www.oasis-open.org/docbook/xml/4.2/ent/iso-amsa.ent:9:19:E:
"X21B7" is not a function name
>
nsgmls:<URL>http://www.oasis-open.org/docbook/xml/4.2/ent/iso-amsa.ent:10:17:E:
"X21D3" is not a function name
Looks like the standard errors you get when dealing with an XML
document as if it were just an SGML document (ie. not providing the
SGML declaration for XML to the parser).
This tool probably only supports SGML DocBook right now. Note that
there are something like 3 different tools to do such a conversion.
--
Yann Dirson <>
http://www.alcove.com/
Technical support manager Responsable de l'assistance
technique
Senior Free-Software Consultant Consultant senior en Logiciels
Libres
Debian developer () D憝eloppeur
Debian
---------------------------------------------------------------------
To unsubscribe, e-mail:
For additional commands, e-mail:
