API documentation

[James Muir <hemlock vtlink net>]

Hi All,

I've been fiddling with the Gnome2::Canvas for several weeks and there 
are a few bits of API information I'd like to document somewhere so that 
the next person who looks at this API has an easier time. I'm wondering 
what the best approach is. It's my impression that the API documentation 
is derived from other sources (POD? Glib::ParamSpec?), and the wiki 
immediately directs you to API pages that cannot be revised.  :-(

What is the best approach to documenting the Gnome2::Canvas API so that 
the additions are not lost the next time the API is derived from its 
original sources?

-James