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

Yes, that's one area that we're improving for the next major
release.
I've never seen it take that long but then I've probably
never imported that many files :(
Rgds Pete

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