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.

Phil

Attachment: signature.asc
Description: Digital signature

_______________________________________________
gtk-doc-list mailing list
[email protected]
http://mail.gnome.org/mailman/listinfo/gtk-doc-list

Reply via email to