|
Hi Phil, On 09/14/11 23:36, Philip Kovacs wrote: 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).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. Stefan Phil_______________________________________________ gtk-doc-list mailing list gtk-doc-list gnome org http://mail.gnome.org/mailman/listinfo/gtk-doc-list |