GNOME Bugzilla – Bug 736073
Regression: problems with enum constants
Last modified: 2015-01-05 17:53:41 UTC
When building the GtkSourceView documentation, I see the following warnings: > DOC Fixing cross-references > html/GtkSourceCompletionInfo.html:91: warning: no link for: 'G-SIGNAL-ACTION:CAPS' -> (Action). > html/GtkSourceGutterRenderer.html:305: warning: no link for: 'G-SIGNAL-RUN-LAST:CAPS' -> (Run Last). > html/GtkSourceCompletion.html:917: warning: no link for: 'GTK-SCROLL-PAGES:CAPS' -> (<code class="literal">GTK_SCROLL_PAGES</code>). For G_SIGNAL_ACTION and G_SIGNAL_RUN_LAST, it comes from the signal definition. For GTK_SCROLL_PAGES, it comes from a reference in a GTK-Doc comment: %GTK_SCROLL_PAGES. When generating the GtkSourceView doc with the latest GTK-Doc version from git, if the cross-references are fixed against the html docs that I install from my Linux distro (GTK+ 3.8 and GLib 2.36, generated with an older GTK-Doc), everything is fine. If I compile the latest GTK+ and GLib docs with the latest GTK-Doc, all from git with jhbuild, then I have the warnings. So the problem probably doesn't come from gtkdoc-fixxref, but from the "available" symbols in GTK+ and GLib. Probably the same problem, if I search G_SIGNAL_ACTION in devhelp, the symbol isn't found (it worked before).
It's a quite major problem, since lots of symbols are not available when searching them in devhelp.
I don't want to play this down, but I simply did not yet had time to investigate. If you want to ping a bug, please use IRC.
Sébastien, what do you get when you run this: grep "G-SIGNAL" /usr/share/gtk-doc/html/gobject/index.sgml <ANCHOR id="G-SIGNAL-TYPE-STATIC-SCOPE:CAPS" href="gobject/gobject-Signals.html#G-SIGNAL-TYPE-STATIC-SCOPE:CAPS"> <ANCHOR id="G-SIGNAL-MATCH-MASK:CAPS" href="gobject/gobject-Signals.html#G-SIGNAL-MATCH-MASK:CAPS"> <ANCHOR id="G-SIGNAL-FLAGS-MASK:CAPS" href="gobject/gobject-Signals.html#G-SIGNAL-FLAGS-MASK:CAPS"> Those docs where generated by gtk-doc 1.20 and don't contan the enum values either. grep "Generated by" /usr/share/gtk-doc/html/gobject/index.html Generated by GTK-Doc V1.20</div> Which version generated your?
I don't have a Fedora 19 around anymore, but from what I've tested the symbols were present in the docs installed from the packages of Fedora 19 (with GTK+ 3.8).
The following fix has been pushed: 68140b1 gtkdoc.xsl: fix index selector optimization
Created attachment 293716 [details] [review] gtkdoc.xsl: fix index selector optimization The index selector was missing para tags. Those wrap e.g. enum entries. Fixes #736073
Thanks, the warnings when compiling the GtkSourceView documentation have now disappeared. But I still cannot search G_SIGNAL_ACTION in devhelp, I'm not sure if it's a gtk-doc or devhelp problem.
This was broken with the markdown changes. We should unify index.sgml and index.devhelp2 - that is make gtkdoc-fixxref use the index.devhelp2 as well. Filed #742404 commit 6d82b2651bac715be19a4d5fbb03052a6c000549 Author: Stefan Sauer <ensonic@users.sf.net> Date: Mon Jan 5 18:44:04 2015 +0100 devhelp: fix missing enum values When changing the layout with the markup parser we broke the constants.