[fpc-pascal] Brook 1.0 - A new framework for web was born
michael.vancanneyt at wisa.be
michael.vancanneyt at wisa.be
Mon Dec 17 10:23:07 CET 2012
On Sun, 16 Dec 2012, Graeme Geldenhuys wrote:
> On 15/12/2012 21:22, Sven Barth wrote:
>>
>> Maybe because the authors prefered inline comments instead of fpdoc's
>> XML files...
>
> A shame, because the more detailed the documentation, the more it obfuscates
> the code.
>
> eg: Documentation Insight, a popular Delphi IDE plugin for documenting
> frameworks from inside the IDE's most requested feature... "external
> documentation files" because good documentation means lots of text and
> examples, thus lots and lots of code obfuscation.
Exactly the reason why fpdoc uses external XML.
A pasdoc-to-fpdoc conversion is on my TODO list. (tracker item 325689871 ;))
Michael.
More information about the fpc-pascal
mailing list