[Bug 681635] Use GTKDOC_REBASE and GTK_DOC_USE_REBASE

[GStreamer (bugzilla.gnome.org)]

https://bugzilla.gnome.org/show_bug.cgi?id=681635
  GStreamer | common | git

--- Comment #5 from LRN <lrn1986 at gmail.com> 2012-08-11 16:06:07 UTC ---
Oh, and the last bit i should have mentioned:

I don't like rebase, because it turns relative hrefs into _absolute_ hrefs.
This is bad already, as it hardcodes absolute paths into docs, making them
non-relocatable. And i see no profit in using absolute hrefs when every bit of
gtk-doc is in the same share/gtk-doc subdirectory, and can easily
cross-reference with relative hrefs just as well.

But it's worse than that. gtkdoc-rebase does not take into account that
"c:/mingw32/share/gtk-doc" is NOT a valid URI (on *nix something like
"/usr/share/gtk-doc" might be, i wouldn't know), and is not accepted by any W32
browser. It should be "file:///c:/mingw32/share/gtk-doc" instead. But gtk-doc
is not smart enough to figure that out. As a result, all rebased docs have
broken hrefs in them. Very annoying.

Now, this might be fixed by patching gtk-doc to be smarter, but since NOT
rebasing the docs works just as well for me, i've taken the easier path -
fixing GStreamer.

-- 
Configure bugmail: https://bugzilla.gnome.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
You are the assignee for the bug.