Improve documentation for private fields of GSourceFuncs
Submitted by Philip Withnall
From bug #697908:
@@ +1185,3 @@
So I'm quite confused by this.
Only the first four fields of GSourceFuncs are documented. The final two fields are annotated:
< private >/
/* For use by g_source_set_closure */
So I would say it's unacceptable to use them. On the other hand, this class already used them before your patch. And the documentation of g_source_set_closure() actually instructs us to use them. IMO that is clearly a GLib documentation bug. Can you file a bug report?