[email protected] 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
_______________________________________________
fpc-devel maillist - [email protected]
http://lists.freepascal.org/mailman/listinfo/fpc-devel
