Linking to library.gnome.org
Recently the brave gtk-doc guys introduced a tool called gtkdoc-rebase, which updates external links in your API docs to point on the GNOME Library. The gtk-doc.make script has been updated to run gtkdoc-rebase on
make dist. Unfortunatly all this pretty stuff doesn't work out of the box on Gutsy, as two premise have to be fulfilled to make this voodoo work:
index.sgmlfiles in the gtk-doc folder must be uncompressed. The gtk-doc and Ubuntu guys currently argue regarding that topic.
- Your uncompressed
index.sgmlfiles must contain an
<ONLINE>tag pointing on the online docs.
Updating all the gtk-docs I've got would have been a boring task. So I wrote a little script which updates the uncompressed index files, when documentation exists in the GNOME Library:
Use it carefully, as it sends
HEAD requests to library.gnome.org for every gtk-doc package not having that
<ONLINE> tag yet.
Did I mention already, that this script processes uncompressed index files only? So call
sudo gunzip /usr/share/gtk-doc/html/*/index.sgml.gz before using it.