[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