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

Have you looked at GenHelpPro?
www.frasersoft.net/genhelp
It lies somewhere between the two.
Rgds Pete

"Erik F. Andersen" <ea@xxxxxxxxx> wrote in message
news:4680f1f8@xxxxxxxxxxxxxxxxxxxxxxxxx
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.


.

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)
  • Which documentation tool (DelphiDoc or Doc-o-Matic)
    ... I'm currently looking at two different documentation tools for Delphi and ... I need the tool for Delphi 2007 and it must be able 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)