GNOME Bugzilla – Bug 644111
one cannot specify against which libs gtkdoc-fixxref should resolve links (problematic with multiple versions)
Last modified: 2014-03-08 20:25:48 UTC
This page http://library.gnome.org/devel/gio/unstable/GApplication.html#GApplication.object-hierarchy has a link to this page, for GtkApplication, http://library.gnome.org/devel/gtk/stable/2.24/GtkApplication.html which does not exist. I guess it should be this: http://library.gnome.org/devel/gtk3/stable/GtkApplication.html
Reassigning to gtk-doc; as it gets crosslinking wrong (but then I don't know how it's supposed to figure GtkApplication is in gtk3/, not gtk/). * As the name indicates, the platform data may vary depending on the * operating system, but it always includes the current directory (key * "cwd"), and optionally the environment (ie the set of environment * variables and their values) of the calling process (key "environ"). * The environment is only added to the platform data if the * #G_APPLICATION_SEND_ENVIONMENT flag is set. GApplication subclasses * can add their own platform data by overriding the @add_platform_data * virtual function. For instance, #GtkApplication adds startup notification * data in this way.
Is this also happening in a installed scenario from devhelp? But indeed I see some confusion ahead for parallel installable libraries with the same symbols (gtk2,gtk3 or gstreamer0.10,gstreamer1.0).
It's the same from devhelp, as the original HTML files (from the GTK+ tarball) are getting their crosslinks wrong, ex: ch25s02.html:<td><a href="http://library.gnome.org/devel/gdk/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a></td>
Could this be because we changed the ids to be gdk3 / gtk3, but we still have the docs in docs/reference/gdk / gtk ?
fwiw there is now a hack in developer.gnome.org to force GDK links from GTK+ 3 to go to the gdk3/ directory. (but the original issue is different).
Maybe we can add --ignore-dirs=dir1,dir2,... to gtkdoc-fixxref. This would list a bunch of dirs from which the index.sgml files should be ignored. Ideally we could somehow derive this from e.g. the CFLAGS / LIBS (grab the gtk-3 libname there).
This is not the most elegant way to fix it. in configure.ac gst_prefix="`pkg-config --variable=prefix gstreamer-1.0`" AC_SUBST(gst_prefix) in Makefile.am FIXXREF_OPTIONS= \ --extra-dir=$(gst_prefix)/share/gtk-doc/html/gstreamer-1.0 \ --extra-dir=$(gst_prefix)/share/gtk-doc/html/gstreamer-libs-1.0 Any ideas. commit 8a768121c437f067edf818e4092a5d668f61d117 Author: Stefan Sauer <ensonic@users.sf.net> Date: Mon Feb 17 11:34:41 2014 +0100 fixxref: sort subdirectories This ensures that symbols in a directory with a higher version number shadow symbols with a lower version. Also drop the revisitation check. The 'links' data is a hashmap, there are no duplicate entries anyway. This way one can use --extra-dir to specify the wanted version. Fixes #644111
*** Bug 698021 has been marked as a duplicate of this bug. ***
*** Bug 723109 has been marked as a duplicate of this bug. ***