doxygen-users

[Doxygen-users] DocJet versus Doxygen for MS IDL?

[Jake K. <jk...@bi...>]

Hi,

I have an interview later this week for a job that currently uses DocJet to document their MS IDL (COM development in C++).  I would
like to suggest maybe converting over to Doxygen, but I don't know what features/abilities they would gain or loose if they did
converted.

So has anyone ever used/compared DocJet from http://www.tall-tree.com/
Specifically to document MS IDL?  The way I understand it, tall-tree uses a filter/remapper to get comments out of the
machine/wizard generated IDL code, but it looks like param names must match the C++ code or DocJet could loose it's place, see:
http://www.tall-tree.com/docjet/Support/IDLRemap/index.html

- What features/abilities would one gain or loose if they did converted from DocJet to Doxygen?
- So is doxygen capable of documenting MS IDL completely?
- Can (how?) does it map the generated COM IDL to developer C++ classes?  (like DocJet Remap?)
- It looks like other have had unanswered question about treating IRecordPtr as an alias for IRecord?  Has anyone solved this?

Thanks for your time,
Jake

[Doxygen-users] DocJet versus Doxygen for MS IDL?

[Christopher B. <bre...@ya...>]

Jake asks:

    What features/abilities would one gain or loose if
    they did converted from DocJet to Doxygen?

I don't know about your questions regarding MS IDL,
but I did some comparing of Dox with DoxJet. Here were
some aspects of the comparison.

Against Docjet:

- Price: Your prospective employers obviously accepts
paying for DocJet, but they might like freeware too. 

- Design: As a tech writer who cares about design, I
find Doxygen's default design good, and I don't like
DocJet's default (headings too large, text too small).
With Doxygen, a simple change to sans-serif type gives
it another look, also good.

- Platform: DocJet was Windows-only when I checked it
out.

- Output: no printable version with DJ



For DocJet:

- Features that work with Dev Studio, including
context-sensitive help.

- Works with Java.

- (This doesn't apply to your situation.) Can be used
with existing comments in code, with no reformatting.


Those are the main differences I noticed.

Christopher Brewster

__________________________________________________
Do You Yahoo!?
Buy the perfect holiday gifts at Yahoo! Shopping.
http://shopping.yahoo.com