1376947
story
bridgette asks:
"I'd like to have a good 'javadocs-like' documentation generator for my C/C++ project. I've been looking into Doc++ but I haven't seen any 3rd party reviews. Anyone out there want to share their experiences with Doc++, good bad or otherwise? Anyone know of any alternatives?"
Brief comments (Score:2)
Overall I was happy with it. My tips would be:
- subscribe to the developers list even as a non-developer. Bugs are introduced, and fixed, on a frequent basis.
- automake targets for this kind of thing are still mildly tricky. That's not doc++'s fault.
- the TeX layout looks pretty good, but tinkering with it requires at least a lesser TeX wizard.
- the code uses multiple state machines written using flex and C++. Check it out, it's pretty funky.
Doxygen (Score:3)
scandoc (Score:2)
The main con about doc++ (IMHO) is the lack of configurability of the output look and feel.
While scandoc will generate only HTML output (and you should look for other tools if LaTeX, TXT, Groff, your-format-here output is desired), it is very configurable, requiring some Perl hacking to get the template to generate what you want.
Here is an example of scandoc-generated documentation [sourceforge.net].
Very nice (Score:1)
DOC++ (Score:2)
Only a couple problems:
I'd almost say its a better javadoc than javadoc, but I really like the doclet idea, even though it hasn't been fully exploited yet.
Re:Doxygen (Score:2)