Re: Resolving cross-references among components

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

On Sun, Nov 18, 2012 at 09:44:27PM +0100, Stefan Sauer wrote:
> I can't add anything here. Do you have a case where this happens?

It should happen everywhere.  For instance, Gdk references Gtk+ symbols
dozens of times.  Why almost no one observes it?  Most of the time if
you build Gtk+, even from a fresh checkout, you already have *some* Gtk+
installed.  So gtkdoc-fixxref takes index.sgml from the system directory.
Occasionally, you miss a couple of new symbols, but who notices it...

I run into this during nightly builds of Gwyddion (too complex to serve
as a clear example) that are done in a relatively clean environment.
Certainly it is not installed anywhere where it could be picked up
during the build.

It would suffice to split the fixxref stage off the normal HTML building
stange and run it once that is done in all subdirectories.  But this
is not possible within gtk-doc.make, it requires the introduction of
some HTML-has-been-built stamp on the package level (or at least inside
some docs subdirectory).

Yeti