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

Reply via email to