[Vala] integrate Vala and GTK doc?

[Adam Dingle <adam medovina org>]

When I write GTK code with Vala, I find myself constantly switching back 
between the C-based GTK documentation (which has C prototypes and lots 
of helpful explanations) and the Vala binding reference at valadoc.org 
(which has Vala prototypes but no explanations at all).  I'd really like 
to see these integrated in some way.  We could either

(a) extract the text from the C-based documentation and insert it into 
the Valadoc automatically, or
(b) somehow hack the C-based documentation so that it shows Vala 
prototypes instead of (or in addition to) the C prototypes

Either approach seems reasonable to me.  Of course, I'd like a solution 
that works not just for the GTK documentation, but for any GNOME-based 
API.  Are there any plans to integrate the documentation in this way?

adam