Re: altering relative references to ../glib

[David Nečas (Yeti) <yeti physics muni cz>]

On Sun, Jul 08, 2007 at 03:46:55PM +0300, Stefan Kost wrote:
> Philip Kovacs wrote:
> > Is there a way to have gtk-doc generate absolute references to
> > 
> > http://developer.gnome.org/doc/API/API/2.0/glib
> > 
> > ...
> > Or do I have to sed that out myself?   I'll need that for web-based
> > documentation.

This is useful not only for web-based documentation but also
as a neutral form of linking when one does not know where
the built documentation will end up.

Currently I do it manually, see

  http://gwyddion.svn.sourceforge.net/viewvc/gwyddion/trunk/gwyddion/devel-docs/ncrosslinks.py?view=markup

and Pango bugs

  http://bugzilla.gnome.org/show_bug.cgi?id=434720
  http://bugzilla.gnome.org/show_bug.cgi?id=432991

...

> yes, that sound useful. Can you please file that as a feature request and let me
> know of the bug-number. Right now I don't have a good idea how to support it.
> One would need to pass the uri to the index.sgml as e.g. --extra-index to
> FIXXREF_OPTIONS. WHile that is technically doable, I don't like the idea of
> hard-coding web-uri's in a number of packages. It would be better if that uri
> could be taken from the local index.sgml and there would be a switch to build
> webdocs (where fixxref would try to use weburis whenever it can).

... however I fully agree packages should provide weburis
themselves.  And I'm willing to implement this feature.
(Leaving the discussion for the bug record...)

Yeti

--
http://gwyddion.net/