the 2 remaining problems i can think of could be solved by some ant tricks to scan the files and fail the build if...
1 it finds a link that doesn't mention an anchor
2 the same anchor name is used in more then one file
...both of which would be things the user who just added the link/anchor could fix.
w/o checks like this, the user could add links or anchors that might look ok in the HTML version of the ref guide, but would be broken in the PDF version.
spun off of #6...
w/o checks like this, the user could add links or anchors that might look ok in the HTML version of the ref guide, but would be broken in the PDF version.