Re: GtkHSV

[Havoc Pennington <hp redhat com>]

Ross Burton <ross burtonini com> writes: 
> One more thing - is there any documentation on gtkdoc?  i.e. how do
> I document a enum, and what are valid in the headers?  I had a look
> through the source code but not all of the comments are in the code
> - I had thought that the API documentation was generated solely from
> the source code (I'm a Java hacker too) but obviously I am wrong.
> Can someone point me in the right direction?

Only functions are done in the code - the rest is in the "template
files", see docs/reference/gtk/tmpl/* - it's a bit more low-tech than
javadoc.

You can also do functions in the template files but we generally
don't.

Re: the patch - thanks! If this is intended for 2.0.0, I think we need
to underscore-prefix all the functions (so they won't be exported) and
port GtkColorSelection over to the new API. Then a bug should be
opened on bugzilla.gnome.org to track the patch, and of course the
patch should be attached to the bug. The bug should be set to the
2.0.0 milestone. Once the patch is applied, the bug should be renamed
to "consider exporting GtkColorWheel" and moved to the 2.2 milestone.

Havoc