This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
Re: Re: DOCBOOK: Manpages in Linux
- From: Fabrice Bacchella <fabrice dot bacchella at synaptique dot com>
- Cc: docbook-apps at lists dot oasis-open dot org
- Date: Fri, 26 Apr 2002 12:24:26 +0200
- Subject: Re: DOCBOOK-APPS: Re: DOCBOOK: Manpages in Linux
- References: <F110KwC4V2fGM587uYF00000085@hotmail.com><200204260525.g3Q5PA214177@c692639-c>
Solaris 8 uses SGML for it's man. In fact, it's even docbook :
<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based
SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1997, v.4001-->
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
]>
Perhap's it gan give you hints.
"Robert A. Whiteside" wrote:
>
> 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