[fpc-devel] FPDoc sources

[Hans-Peter Diettrich]

michael.vancanneyt at wisa.be schrieb:

>> IMO fpdoc should always create output from the given xml files, 
>> regardless of whether according source files are also given.
> 
> If you think logically for a moment, you'll understand why this is 
> simply not
> possible.

It is easily possible, of course. When I want documentation created from 
source files, then I use something like PasDoc. When I create xml files 
for fpdoc, I expect that these form the base of the documentation. 
Everything else is unlogical :-(

> I'm surprised you even ask this question.

Because it's annoying when I cannot create the content files for rtl and 
fcl (on Windows), required in building the lcl documentation. I'm 
missing fpdoc project files for the rtl and fcl, from which 
documentation can be built without using Make on Linux.

The requirement for perfectly compilable source files, with all options 
and include files, stands in contrast to building mere documentation. 
Since fpdoc offers no means to add target specific documentation in the 
xml files, it should be able to build target-insensitive documentation.

Furthermore, when fpdoc requires package names, why can't it read the 
source files from the package files, and then look for xml files of the 
same names in the xml directory of the package?

DoDi