views:

611

answers:

6

I am looking for a code documentation tool like PasDoc that supports the Delphi 2007 syntax, in particular nested types.

I checked PasDoc and DelphiDoc but they do not support it.

I don't like the syntax of the builtin XMLDoc but would prefer something more JavaDoc like (that is: Shorter tag syntax, not quite as verbose as

<summary>
...
<param>
...

etc.)

+2  A: 

Did you check out DelphiCodeToDoc? I am not sure about the exact support of Nested types but I was pretty happy with the results last time I used it.

Hemant
Thanks for the tip, but apparently Delphi Code2Doc doesn't support nexted types either (crashes when I try it).
dummzeuch
+2  A: 

Have you looked at the --doc switch for the Delphi compiler? AFAIK, the Delphi compiler understands the Delphi syntax pretty well ;-).

Allen Bauer
Is http://edn.embarcadero.com/article/32770 still the relevant page about XMLDoc for Delphi? Are there any other free or commercial tools which can be used?
mjustin
But does it understand JavaDoc style comments? AFAIK it only undertands XMLDoc which for my taste is too verbose.
dummzeuch
+1  A: 

Pascal Browser from www.peganza.com creates very comprehensive documentation and can be customized to some extent.

frogb
A: 

Currently I am still using a combination of doxygen and pas2dox which works quite well. pas2dox converts the source into a C/C++ like document which can be parsed by doxygen. So maybe this (quite old) tool works as expected. If I have the time to test it with Delphi 2009 I'll post the results here. And the good thing about doxygen is that Javadoc style is supported.

mjustin
+4  A: 

Doc-O-Matic supports the Delphi 2009 Generics and also JavaDoc like syntax.

mjustin
A: 

if you have issue with DelphiCodeToDoc with nested type, please, send me example or give me clue so I will try to fix it !

TridenT
Have you solve this point with DelphiCodeToDoc or another tool ?
TridenT