Re: GNOME document autogeneration...

[Jeff Garzik <jgarzik pobox com>]

(added gnome-doc-list to cc)

Michael Fulbright wrote:
> rosalia@cygnus.com said:
> > Mike: can you explain a bit more about your decision?

> The gtk+ guys have a system in place and working. That is sufficient for
> us - we do not see there is time to reinvent the wheel here.
> 
> If there is a competing system available that is producing documentation
> and is packaged and ready to go I'm willing to consider it.  

Look in gnome-libs/tools/gnome-doc.  It's there, it works, it produces
DocBook, HTML, or text.  I have already started doc'ing libgnomeui
using this, so your announcement took me by surprise.

I will start checking my docs in today, so that whoever does the
libgnomeui docs using the RH Labs doc system can benefit from my work.


> Federico and I talked with Owen Taylor a bit about this and we decided we
> didn't like a system based on putting documentation in the actual source code.

I'm interested, what reasons?

	Jeff