DOCBOOK-APPS: Re: DOCBOOK: Manpages in Linux

["Robert A. Whiteside" <ra-whiteside at attbi dot com>]

Hi Karif,

   I'm far from an expert,  but perhaps this helps:

On Thursday 25 April 2002 09:18 pm, you wrote:
>
> Problems:
>
> The docbook2man utility does not handle XML properly.

Actually, the version I'm running claims not to support XML at all.  However, 
I find that "docbook2pdf", for example, works fine with my XML docbooks. It 
emits a complaint about my <!DOCBOOK header, but then proceeds to generate a 
fine pdf file.   YMMV, of course.


> Some of the docbooks rules are not good for my purposes (pending).

Not a clue what this means.


> DocBook XML is poorly documented and it is hard to find samples.

I feel your pain.  Actually, I find that there's a plethora of stuff out 
there.  Much of it, however, assumes I know more than I do.  I keep feeling 
that Real Soon Now it'll all come together, but I'm not quit there yet. 

I live with Norm Walsh's book: "DocBook: The definitive guide" at my elbow.  
Per your problem, he gives docbook examples for documenting a command and a C 
method.  

RefEntry is your friend here, I think.


>
> I can't find an XML parser and Validator for Linux or Unix.

Hmmm ... Did you ask Google about "validating xml parser"?  I certainly get 
hits for that.  I've used Xerces, but there are certainly others. 

Cheers,
--Bob