Re: 1.17 cross refs



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



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]