views:

504

answers:

5

Is there any free HTML creating documentation tool that fully understands Delphi 2009 features like generics and anonymous methods?

I tried DelphiCodeToDoc but it crashes while parsing the source code.

+3  A: 

If you have the Enterprise or Architect SKUs, there's an option to generate documentation. I haven't used it in 2009, so I can't say how well it handles generics and anonymous methods.

Bruce McGee
+1 Thanks for the hint. Anyway, I seem to have Together installed (I can watch the model view with the class diagrams and have options for documentation generation in the tools options menu), but the menu entry for generating the documentation is missing...any hints?
Smasher
The Generate Documentation option is enabled for me as soon as I add modeling support to a project (Delphi 2009 Architect). What SKU do you have? I'm pretty sure this isn't available in Professional.
Bruce McGee
I have the Professional version...did they just remove the menu entry? All the documentation related settings are available...strange
Smasher
I'm not sure how if the feature is removed from the professional SKU or just hidden.
Bruce McGee
A: 

See this question for suggestions (but no solution): is-there-a-delphi-code-documentor-that-supports-current-delphi-syntax

dummzeuch
Yes, I have seen that question, but (1) as you said, there is no solution (2) it does only mention D2007 support, not D2009 support. That's why I decided to ask a new question. Thanks for the link though!
Smasher
+1  A: 

Delphi 2009 Professional allows the selection of "Generate XML Documentation", this outputs a .xml file that represents the code and documentation in that file. You would have to write XSL transforms to produce actual usable documentation from this. We have built a system that builds wiki pages and uploads this to out internal documentation system, but you could produce windows help files, etc as well.

Mmarquee
+4  A: 

Doc-O-Matic is available in a free command line version, and supports Delphi 2009.

Doc-O-Matic Express is a command line tool, it generates Web Help/browser based Help, HTML Help and Help 2 output directly from the source code and in-source comments.

It is fast, and the output looks quite nice. I am not using it for my commercial projects yet but it is a candidate.

mjustin
Accepted. Doc-O-Matic is great. The only missing thing in the free version (IMHO) is the links from a class page to its members.
Smasher
A: 

As onnodb said, I'm very interrested to have any feedback on the issue you had with DelphiCodeToDoc ... even if it was 1 year ago :)

TridenT