After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 632587 - gtkdoc-scanner fails to identify (closure) annotation
gtkdoc-scanner fails to identify (closure) annotation
Status: RESOLVED FIXED
Product: gtk-doc
Classification: Platform
Component: general
1.15
Other Linux
: Normal normal
: 1.16
Assigned To: gtk-doc maintainers
gtk-doc maintainers
Depends on:
Blocks:
 
 
Reported: 2010-10-19 18:49 UTC by Travis Reitter
Modified: 2010-10-20 09:02 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Travis Reitter 2010-10-19 18:49:39 UTC
I get this invalid warning:

/home/treitter/checkout/gnome/folks/docs/gtk-doc/folks/ccomments/groupable.c:20: warning: unknown annotation "closure" in documentation for folks_groupable_change_group.

for the following chunk of documentation:

/**
 * folks_groupable_change_group
 * @self: the <link linkend="FolksGroupable"><type>FolksGroupable</type></link> instance
 * @group: (in): a freeform group identifier 
 * @is_member: (in): whether the contact should be a member of the group 
 * @_callback_: (scope async): callback to call when the request is satisfied
 * @_user_data_: (closure): the data to pass to @_callback_ function
 * 
 * Add or remove the contact from the specified group. 
 * 
 * <para>If <blockquote>is_member</blockquote> is <blockquote>true</blockquote>, the contact will be added to the <blockquote>group</blockquote>. If it is <blockquote>false</blockquote>, they will be removed from the <blockquote>group</blockquote>. </para>
 * 
 * <emphasis>See also</emphasis>: <link linkend="folks-groupable-change-group-finish"><function>folks_groupable_change_group_finish()</function></link>
 *
 * Since: 0.1.11
 */

=====================================

See the GObjectIntrospection annotation for (closure).
Comment 1 Stefan Sauer (gstreamer, gtkdoc dev) 2010-10-20 09:02:07 UTC
commit 0f823987820f1b15a07b2464149c9221b360033a
Author: Stefan Kost <ensonic@users.sf.net>
Date:   Wed Oct 20 12:00:25 2010 +0300

    mkdb: add support for "closure" annotation
    
    Fixes #632587.