Which documentation tool (DelphiDoc or Doc-o-Matic)



Hello!

I'm currently looking at two different documentation tools for Delphi and
I'm having difficulty deciding which one to use. The two tools are DelphiDoc
and Doc-o-Matic. I need the tool for Delphi 2007 and it must be able to
integrate with ModelMaker 9. It should also be used to generate help-files
from source-code.

Here are the pros and cons I have found so far.

* DelphiDoc
pro: Free
pro: Fast parsing of source-code
pro: Can generate Win32 help files, WinHelp and PDF's
con: Proprietary help formatting commands
con: Does not fully support Delphi 2007 syntax
con: Unclear if it can convert ModelMaker 9 documentation to PDF in a
satisfactory way (currently I use ModelMaker to document databases via
records and ER-Diagrams).

* Doc-o-Matic
pro: Support XMLDoc
pro: Can generate very nice PDF's from ModelMaker 9 documentation (via an
export plug-in to ModelMaker)
pro: Very flexible documentation generation
pro: Can generate Win32 help files, WinHelp and PDF's
con: Rather expensive ($999 for Prof. version. I need that for PDF
generation)
con: Very slow parsing of source-code compared to DelphiDoc
con: Consumes extreme amount of memory (I have about 60000 items and it
crashed on a machine with 1GB RAM)

I would also like for the tool to support Delphi.Net, but as far as I can
determine none of the above can do this at the moment.

Anyone care to comment on this? I realise that my list is not complete. It
merly reflects my current needs, but other arguments for one over the other
is appreciated as well.

Regards,
Erik


.



Relevant Pages

  • Re: Which documentation tool (DelphiDoc or Doc-o-Matic)
    ... documentation in PDF ... It must be able to read Delphi 2007 files. ... pro: Fast parsing of source-code ... con: Does not fully support Delphi 2007 syntax ...
    (borland.public.delphi.thirdpartytools.general)
  • Re: Which documentation tool (DelphiDoc or Doc-o-Matic)
    ... I'm currently looking at two different documentation tools ... for Delphi and I'm having difficulty deciding which one to ... pro: Fast parsing of source-code ... con: Does not fully support Delphi 2007 syntax ...
    (borland.public.delphi.thirdpartytools.general)
  • Re: Which documentation tool (DelphiDoc or Doc-o-Matic)
    ... I need the tool for Delphi 2007 and it must ... be able to integrate with ModelMaker 9. ... pro: Fast parsing of source-code ... con: Does not fully support Delphi 2007 syntax ...
    (borland.public.delphi.thirdpartytools.general)
  • Re: Which documentation tool (DelphiDoc or Doc-o-Matic)
    ... I need the tool for Delphi 2007 and it must be ... able to integrate with ModelMaker 9. ... pro: Fast parsing of source-code ... con: Does not fully support Delphi 2007 syntax ...
    (borland.public.delphi.thirdpartytools.general)
  • Re: Recommendation for text/writing app?
    ... Con: Weak word processing capabilities. ... documentation very inadequate and the features to be impoverished. ... Pro: The standard. ...
    (comp.sys.mac.advocacy)