Re: GNOME document autogeneration...

[Jeff Garzik <jgarzik pobox com>]

Elliot Lee wrote:
> gnome-doc is what we can definitely use for the inline documentation (aka
> project "source code will be readable" :), but it is not flexible enough
> or powerful enough to practically allow doing things like usage examples,
> many paragraphs of description, sidebars, etc. which the GTK+ system does.

Still something I don't understand; will the GTK+ system actually use
the in-source comment docs?

Or will someone simply refer to the docs in the code, when writing the
"real" GNOME docs?

Thanks,

	Jeff