[fpc-devel] convert comment help to fpcdoc

Marco van de Voort marcov at stack.nl
Tue Jul 19 15:20:01 CEST 2011


In our previous episode, Wimpie Nortje said:
> >
> Are you aware of NaturalDocs (www.naturaldocs.org)?
> 
> I use it because it doesn't clutter up the source code with unreadable 
> javadoc tags. The comments are naturally formatted. They seem to be just 
> normal comments if you are not aware that NaturalDocs is being used.

Yes, I looked at it, but IMHO while it is probably less work, creating
quality docs in it (more than mere annotations) is IMHO harder. 
 
> I think the current version is written in some scripting language that 
> can easily be modified to provide different output from the current html.

The trouble with that philosophy is that then the burden of keeping the doc
system running falls on one or two persons that are fluent in the scripting
language.

> Unfortunately it doesn't 'know' pascal as good as pasdoc does, but the 
> clear syntax makes up for it.

IMHO we don´t need to change at all, and fpdoc is already better than the
other two.



More information about the fpc-devel mailing list