Improve documentation for private fields of GSourceFuncs
Submitted by Philip Withnall @pwithnall
Link to original bug (#789815)
Description
From bug #697908:
@@ +1185,3 @@
- gnutls_source_dispatch,
- gnutls_source_finalize,
- (GSourceFunc)g_tls_connection_gnutls_source_dtls_closure_callback,
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?
Version: 2.54.x