Re: man pages and GNOME docs

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

>     >>  But we can probably do better than the GNU standards
>     >> recommend: DocBook allows man page information to be embedded
>     >> in your DocBook document (via the <refentry> tag), and we
>     >> should use that mechanism.  You can then process the DocBook
>     >> file and get a man page source as output!
>
>     Toshio> I have gotten to the place where I want to add a man page
>     Toshio> to my documentation (Well, a man page stub to show myself
>     Toshio> how it works.)  I've put the page in, but I now have three
>
> Dude, you are away ahead of me, so your docs will be a great way for
> me to figure out how to do this.
>
> Do you mind if I use *you* to experiment with refentry stuff?  Start
> by sending me your DocBook document (or a pointer to it), and then I
> will look in to answering your questions.

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.

Best regards.

                                                    - Tom