Re: [docbook-apps] DocBook/XML --> [tgn]roff

["Dennis Grace" <dgrace@us.ibm.com>]

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
dgrace@us.ibm.com

If God dropped acid, would He see people?


                                                                                                                                       
                      Yann Dirson                                                                                                      
                      <ydirson@fr.alcov        To:       Sam Steingold <sds@gnu.org>                                                   
                      e.com>                   cc:       docbook-apps@lists.oasis-open.org                                             
                                               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 <Yann.Dirson@fr.alcove.com>
http://www.alcove.com/
Technical support manager                Responsable de l'assistance
technique
Senior Free-Software Consultant          Consultant senior en Logiciels
Libres
Debian developer (dirson@debian.org)                        Développeur
Debian

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org