Re: man pages and GNOME docs

["Thomas G. Lockhart" <lockhart alumni caltech edu>]

> Hey!  That looks really nice!
> Do you have the sgml source somewhere publically accessible as well?
> They'd be nice to look through as an example.

Yes, the source is pointed to at

  http://alumni.caltech.edu/~lockhart/postgres/index.html

(Click on "the docbook source code")

I'm in the middle of doing final hardcopy formatting for ~200 pages of these docs, and what is posted on the web page is from
a month ago. However, the RefEntry examples haven't changed.

btw, most of my usage comes from cutting and pasting from the O'Reilly "DocBook Elements" web page examples. My RefEntry
source is particularly cluttered with elements from their example which I didn't use but didn't throw away either, thinking I
should use it later.

> > I've been generating docs for PostgreSQL using Mark's packages and have
> > been using the RefEntry tags for html and hardcopy. Look at
> >
> >   http://alumni.caltech.edu/~lockhart/postgres/doc/html/index.html
> >
> > for examples (~2/3 of the way down the TOC inside the SPI chapter).
> >
> > I want also to generate man pages and would be interested in your
> > suggestions or recommendations.
> >
> > btw Toshio, there are ways to include other source documents using
> > DocBook, and I have already experimented with making a "man" directory
> > under the rest of my sgml, with each "man page" source in a separate
> > file. Don't know which stylesheet to use to get real man pages though;
> > I don't think Norm's sheets address this.