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 598732 - Issues when using GI annotations
Issues when using GI annotations
Status: RESOLVED FIXED
Product: gtk-doc
Classification: Platform
Component: general
1.11
Other Linux
: Normal normal
: ---
Assigned To: gtk-doc maintainers
gtk-doc maintainers
Depends on:
Blocks:
 
 
Reported: 2009-10-16 21:24 UTC by David Zeuthen (not reading bugmail)
Modified: 2009-10-27 20:32 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description David Zeuthen (not reading bugmail) 2009-10-16 21:24:06 UTC
This is with version 1.11

<davidz> here's an example of that: http://www.kernel.org/pub/linux/utils/kernel/hotplug/gudev/GUdevClient.html#g-udev-client-query-by-subsystem
 for some reason it also sneaks in a link to http://foldoc.doc.ic.ac.uk/foldoc/foldoc.cgi?query=element-type
<ensonic> walters: the glossary or the link in the param desc? just let me know how it should look like - that stuff is easy to be changed
<ensonic> davidz: the foldoc is a fallback for unknown glosary terms
<davidz> ensonic: this is the source: http://git.kernel.org/?p=linux/hotplug/udev.git;a=blob;f=extras/gudev/gudevclient.c;h=fa31f70bf5b278381892e62414ada57c8ce12f98;hb=HEAD#l317
<ensonic> davidz: hmm thast weird one, please file a bug to gtk-doc with a link to the source
<davidz> e.g.
 Returns: (element-type GUdevDevice): A list of #GUdevDevice objects. The caller should free the result by using g_object_unref() on each element in the list and then g_list_free() on the list.
 ensonic: will do
<ensonic> davidz: please also try git HEAD of gtk-doc :)
<ensonic> I know I should do a realease :(
Comment 1 Stefan Sauer (gstreamer, gtkdoc dev) 2009-10-20 14:50:38 UTC
This is already fixed in git HEAD. I added a test for that case to be sure though.


commit 24c09b265f51ade4ce0b9f322ae287df6f2d8fbe
Author: Stefan Kost <ensonic@users.sf.net>
Date:   Tue Oct 20 17:43:08 2009 +0300

    tests: add a test for annotations in returns
Comment 2 Stefan Sauer (gstreamer, gtkdoc dev) 2009-10-27 20:32:13 UTC
David, someone had same problem on the mailing list. This is the tip I gave there in case thats explains your problem:

Have you added
    <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
to your master document? See tests/annotations/docs/tester-docs.xml near to the end. The xslt does a fallback if the local links do not exist.