On Tue, 4 Dec 2012, Graeme Geldenhuys wrote:
Hi,
This seems new in FPC 2.7.1. I have some 15-20 units in my .xml project
file that fpdoc uses, but only a select few units generate output like
"Parsing used unit ..."
What does that output mean? Is in some error? And why the output only
for a few units, and not all units?
Ah. This has to do with the referencing and ordering of units.
Imagine unit A and unit B. Unit A references unit B.
You create somewhere in A's documentation a link to an identifier in unit B.
You specify units A and B on the command line, in that order.
If everything is done in the order as specified on the command-line,
when parsing and documenting A, fpdoc cannot yet find a reference
to an element in unit B, because B was not yet processed.
So now, if it encounters unit B in the uses clause, and finds unit B also
in need of documenting, unit B is processed first (recursively).
Then all references to identifiers in unit B in the documentation of
unit A will be resolved.
Michael.
_______________________________________________
fpc-pascal maillist - fpc-pascal@lists.freepascal.org
http://lists.freepascal.org/mailman/listinfo/fpc-pascal