[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

Stefan Sauer (gstreamer, gtkdoc dev) <ensonic> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |ensonic at sonicpulse.de

--- Comment #6 from Stefan Sauer (gstreamer, gtkdoc dev) <ensonic at sonicpulse.de> 2012-08-11 19:58:53 UTC ---
(In reply to comment #5)
> 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.

This is not the case. It is possible to have the docs in several places (e.g.
when installing a devel version in home).

> 
> 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.

File a bug against gtk-doc please.

> 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.

Cool if it works for you, but you are aware that gtkdoc-rebase was not added
just for the fun of it.

-- 
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.