[fpc-pascal] Brook 1.0 - A new framework for web was born

Graeme Geldenhuys graeme at geldenhuys.co.uk
Mon Dec 17 00:32:00 CET 2012


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.

Anyway, it the Brook author's choice.

Regards,
   - Graeme -




More information about the fpc-pascal mailing list