Public bug reported:

Binary package hint: gtk-doc-tools

One of the primary function of gtkdoc-fixxref is to point references to
standard GLib, Gtk+, etc. symbols (types, functions, macros, etc.) in
generated documentation to the system documentation if present.  In
other words, if another library documentation references GtkWidget, it
is changed to hyperlink to GtkWidget description in Gtk+ documentation.

This does not work at all on Ubuntu: all cross-library hyperlinks are
missing if some documentation is rebuilt there.

The reason is that gtkdoc-fixxref looks for index.sgml (line 121) which
is of course not there because Debian tends to compress random files in
/usr/share/doc, so only index.sgml.gz is present, which is first not
looked for and second it would have to be decompressed (the cross-
linking information is retrieved from it).

But instead of tweaking gtk-doc-tools, I would dare to suggest to just
stop compressing index.sgml in affected packages libglib2.0-doc,
libatk1.0-doc, libpango1.0-doc, libgtk2.0-doc, libgtkglext1-doc, etc.

** Affects: gtk-doc (Ubuntu)
     Importance: Undecided
         Status: Unconfirmed

-- 
gtkdoc-fixxref broken by compressed documentation
https://launchpad.net/bugs/77138

-- 
ubuntu-bugs mailing list
ubuntu-bugs@lists.ubuntu.com
https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs

Reply via email to