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 615550 - gtk-doc fails to recognize (scope ...) and (skip) annotations
gtk-doc fails to recognize (scope ...) and (skip) annotations
Status: RESOLVED FIXED
Product: gtk-doc
Classification: Platform
Component: general
1.15
Other Linux
: Normal normal
: 1.15
Assigned To: gtk-doc maintainers
gtk-doc maintainers
Depends on:
Blocks: 576595
 
 
Reported: 2010-04-12 17:09 UTC by Andreas Rottmann
Modified: 2010-04-13 09:15 UTC
See Also:
GNOME target: ---
GNOME version: ---

Attachments
Add (scope async) and (skip) annotations to the testsuite (1.83 KB, patch)
2010-04-12 17:09 UTC, Andreas Rottmann 		none Details | Review
Add support for (scope async) and (skip) annotations (3.56 KB, patch)
2010-04-12 18:06 UTC, Andreas Rottmann 		none Details | Review

Description Andreas Rottmann 2010-04-12 17:09:08 UTC 
Created attachment 158506 [details] [review]
Add (scope async) and (skip) annotations to the testsuite

While these annotations are documented at <http://live.gnome.org/GObjectIntrospection/Annotations>, gtk-doc fails deal with them. After applying the attached patch to the gtk-doc testsuite, I get these warnings:

make[4]: Entering directory `/home/rotty/src/gtk-doc/tests/annotations/docs'
gtk-doc: 19:03:13.340035524: Scanning header files
gtk-doc: 19:03:13.430889141: Building XML
../../../tests/annotations/src/tester.c:93: warning: Symbol name not found at the start of the comment block.
../../../tests/annotations/src/tester.c:105: warning: unknown annotation "scope async" in documentation for annotation_scope.

Please add support for these annotations, they are needed to fix Bug #576595 (gobject-introspection support for libsoup).
Comment 1 Andreas Rottmann 2010-04-12 18:06:31 UTC 
Created attachment 158515 [details] [review]
Add support for (scope async) and (skip) annotations
Comment 2 Stefan Sauer (gstreamer, gtkdoc dev) 2010-04-13 09:15:25 UTC 
Thanks. Pushed (except the changes to the types file).

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>.