[fpc-devel] FPDoc improvements

[Hans-Peter Diettrich]

michael.vancanneyt at wisa.be schrieb:
> On Fri, 27 Jan 2012, Hans-Peter Diettrich wrote:
> 
>>> should first document dependent units. It currently does not know how 
>>> to do this by itself.
>>
>> Again, what are you talking about? FPDoc doesn't require a special 
>> order of input files, neither source nor documentation files :-)
> 
> It does, see the explanation of Marco.

I still don't understand this requirement, and how documentation writers 
should establish the correct order :-(

> Which is why I again removed the input-dir option (but this is not yet 
> committed).

I see no need for removing this feature. A user can sort the files 
later, in the project files, when fpdoc gave hints on what should be 
improved.

In the meantime I implemented the improved --input and --input-dir 
options in the FPDocManager. They require no modification of the fpdoc 
units, but can be added there as well. Essentially the file and file 
list specifiers are extended, so that common compiler options can be 
appended to the (automatically generated or explicitly given) file list.

I'm not sure yet how to implement the --output-dir option, it affects 
the --output, --content and --import values, and should be implemented 
in fpdoc itself. For now I try to implement it in the FPDocManager, and 
leave it to you to eventually add it to fpdoc as well.

DoDi