3.2.2 descr

This option species the name of a description le that contains the actual documentation for the unit. This option can be given several times, for several description les. The le will be searched relative to the current directory. No extension is added to the le, it should be a complete lename.

If the lename starts with an 'at' sign @, then it is interpreted as a text le which contains a list of lenames, one per line. Each of these les will be added to the list of description les.

The nodes in the description les will be merged into one big tree. This means that the documentation can be divided over multiple les. When merging the description les, nodes that occur twice will end up only once in the big node tree: the last node will always be the node that ends up in the parse tree. This means that the order of the various input commands or the ordering of the les in the le list is important.

Examples:

--descr=crt.xml

will tell FPDoc to read documentation from crt.xml, while

--descr=@fcl.lst

will tell FPDoc to read lenames from fcl.lst; each of the lenames found in it will be added to the list of les to be scanned for descriptions.