[fpc-pascal] fpdoc output "parsing used unit..."

[Michael Van Canneyt]

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.