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

Hello!

Just did a quick test with GenHelpPro. Parsing of about 1300 files takes
around 4 hours. That makes it useless to me.

Regards,
Erik

"Pete Fraser" <pete.nospam.fraser.nospam@xxxxxxxxxxxxxxxxxxxxx> skrev i en
meddelelse news:4680f72e@xxxxxxxxxxxxxxxxxxxxxxxxx
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)
  • 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'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)
  • 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: Archbishop criticizes Israel for "safrificing innocent civilians"
    ... but you never present anything pro or con to relevant points. ... who substitues his own "doctrinal statement" for the Nicene Creed. ... That only proves that you have a knack for picking bad seminaries for ...
    (soc.religion.christian)