GNOME Bugzilla – Bug 512810
libsoup 2.2.x and libsoup 2.3.x install gtk-doc files in the same location
Last modified: 2008-02-25 19:29:09 UTC
Both versions of libsoup install gtk-doc files in /usr/share/gtk-doc/html/libsoup. This keeps gentoo from slotting them properly, and keeps the user from having boths sets of docs installed.
fixed in svn
Created attachment 104209 [details] [review] patch to libsoup 2.2.104 to adjust gtk-doc install dir For reference, here's the patch that can be applied to libsoup 2.2.104 to make it install docs into /usr/share/gtk-doc/html/libsoup-2.2/, for consistency.
If I analyzed this correctly, this breaks devhelp. Looking at the strace output, devhelp seems to do the equivalent of "for dirname in /usr/share/gtk-doc/html/ do; read-in-from $dirname/$dirname.devhelp2; done" which breaks if libsoup only overrides the dirname, but not the devhelp file. Is there any reason for not doing the override in Makefile.am, but instead changing the DOC_MODULE variable to be libsoup-$(SOUP_API_VERSION) ? Apart from that fact, devhelp would be very confused about identical symbols anyway, so I wonder about the usefulness of having to sets of documentation installed.
I just tried it and realized that changing DOC_MODULE breaks the whole setup as gtk-doc expects the sections file etc named like DOC_MODULE, so i retract my suggestion of changing DOC_MODULE. But the change still breaks devhelp.
fixed. (see bug 518384)