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 575797 - gtk-doc generation fails
gtk-doc generation fails
Status: RESOLVED DUPLICATE of bug 575574
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-03-18 07:33 UTC by Götz Waschk
Modified: 2009-03-18 09:35 UTC
See Also:
GNOME target: ---
GNOME version: ---


Description Götz Waschk 2009-03-18 07:33:35 UTC 
This is on Mandriva Cooker, I have gtk-doc 1.11:

gtk-doc: Building XML
cd . && \
        gtkdoc-mkdb --module=libgimpbase --source-dir=../../libgimpbase --output-format=xml --expand-content-files="" --main-sgml-file=libgimpbase-docs.sgml --sgml-mode --output-format=xml
50% symbol docs coverage (98 symbols documented, 0 symbols incomplete, 97 not documented)
See libgimpbase-undocumented.txt for a list of missing docs.
The doc coverage percentage doesn't include intro sections.
cmp: ungültiger --ignore-initial-Wert »./xml/api-index-GIMP«.
cmp: »cmp --help« gibt Ihnen mehr Informationen.
Error running 'cmp ./xml/api-index-GIMP 2.2.xml ./xml/api-index-GIMP 2.2.new' at /usr/share/gtk-doc/data/gtkdoc-common.pl line 60.
make: *** [sgml-build.stamp] Fehler 2
Comment 1 Sven Neumann 2009-03-18 08:26:09 UTC 
Obviously a bug in gtk-doc, not in GIMP.
Comment 2 Götz Waschk 2009-03-18 08:40:43 UTC 

*** This bug has been marked as a duplicate of 575574 ***
Comment 3 Stefan Sauer (gstreamer, gtkdoc dev) 2009-03-18 09:35:06 UTC 
Also to explain the root of the problem (will add warnings for it). You misuse the Since tag. The Since tags should be like:
 * Since: 0.11
But if you do
 * Since: 0.11 in older versions use ...
Then gtk-doc will try to make an api index for version "0.11 in older veri..." and name the file accordingly.