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 759017 - autogenerated ids in return and parameter blocks
autogenerated ids in return and parameter blocks
Status: RESOLVED FIXED
Product: gtk-doc
Classification: Platform
Component: general
1.25
Other Linux
: Normal normal
: 1.25
Assigned To: gtk-doc maintainers
gtk-doc maintainers
Depends on:
Blocks:
 
 
Reported: 2015-12-04 10:24 UTC by Stefan Sauer (gstreamer, gtkdoc dev)
Modified: 2015-12-04 10:55 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Stefan Sauer (gstreamer, gtkdoc dev) 2015-12-04 10:24:47 UTC
The output contain tags that get an auto-id and those unfortunately change when things get inserted:

 <div class="refsect3">
-<a name="id-1.2.2.6.14.5"></a><h4>Parameters</h4>
+<a name="id-1.2.2.6.16.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">

 <div class="refsect3">
-<a name="id-1.2.2.6.12.5"></a><h4>Returns</h4>
+<a name="id-1.2.2.6.14.5"></a><h4>Returns</h4>
 <p> result</p>
 </div>

This is creating unnecessary delta. Either we can avoid id's there or set them ourself.
Comment 1 Stefan Sauer (gstreamer, gtkdoc dev) 2015-12-04 10:55:46 UTC
commit 09d55cf92ee451e76418a0f40a3d54422d98c56c
Author: Stefan Sauer <ensonic@users.sf.net>
Date:   Fri Dec 4 11:53:42 2015 +0100

    mkdb: add id attribs to refsect3 tags
    
    Avoids docbook creating ids. This makes our generated files more stable.
    Fixes #759017