This is the mail archive of the docbook-apps@lists.oasis-open.org mailing list .


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

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


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 at us dot ibm dot com

If God dropped acid, would He see people?


                                                                                                                                       
                      Yann Dirson                                                                                                      
                      <ydirson at fr dot alcov        To:       Sam Steingold <sds at gnu dot org>                                                   
                      e.com>                   cc:       docbook-apps at lists dot oasis-open dot 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 dot Dirson at fr dot alcove dot 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 at debian dot org)                        Développeur
Debian

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







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


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]