Hi Phil, On 09/14/11 23:36, Philip Kovacs wrote: > I observe that the process to build fully linked documentation from a > pristine > source tree (dist|maintainer clean) is two-pass when there are subtrees that > have cross references to each other. This is understandable, as there must > be > html files in the subtrees in order to fix the cross references. > > So, from a pristine tree, one needs to build, e.g. as follows: > > ./autogen.sh > ./configure --enable-gtk-doc [...] > make (<- observe crossref errors to subtrees not yet built) > cd docs/reference > make clean > make > > Obviously you can adjust the Makefile.am to build the doc subtrees in the > desired > order, but when there are circular cross references (subtree a xrefs to b and > b xrefs to a), you must build docs with two make passes. I'd suggest to adjust the order in Makefile.am. Having circular dependencies will not only bit you when building the docs. We do have a bug for the shortcomings of the fixxref warnings (https://bugzilla.gnome.org/show_bug.cgi?id=658359) although those described there have different reasons. If you can think of a scheme that would address the particualr issues you have, please let us know - I can't think of a solution right now (except building twice).
Stefan > Phil > > > _______________________________________________ > gtk-doc-list mailing list > gtk-doc-list@gnome.org > http://mail.gnome.org/mailman/listinfo/gtk-doc-list
_______________________________________________ gtk-doc-list mailing list gtk-doc-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-doc-list
