GNOME Bugzilla – Bug 636394
Support function toplevel annotations
Last modified: 2010-12-04 17:05:54 UTC
GI has added the concept of a "top" annotation, like the (skip) seen here: /** * gtk_tree_selection_get_select_function: (skip) * @selection: A #GtkTreeSelection. * * Returns the current selection function. * * Return value: The function. * * Since: 2.14 **/ GtkTreeSelectionFunc gtk_tree_selection_get_select_function (GtkTreeSelection *selection) gtk-doc ideally should as a first step ignore these (handling the individual semantics of them would be nice but is not important for now)
How are those interpreted? Are they applied to the whole block (like all parameters). Would one do that for a SECTION: comment. According to: http://live.gnome.org/GObjectIntrospection/Annotations (skip) is the only one (right now). I'll try what would happen right now and handle that in the the parser.
Nevermind, this was already implemented by: commit 0a874b3a2d97476caf8100386ceed5070a2d065e Author: Andreas Rottmann <a.rottmann@gmx.at> Date: Tue Apr 13 11:31:03 2010 +0300 Add support for `scope' and `skip' annotations See <http://bugzilla.gnome.org/show_bug.cgi?id=615550>. Someone just used the wrong annotation syntax.