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.
_______________________________________________
fpc-pascal maillist  -  fpc-pascal@lists.freepascal.org
http://lists.freepascal.org/mailman/listinfo/fpc-pascal

Reply via email to