I’ve just had a quick look at a few doclet generators for C++.

Here’s my list.

• Doxygen – Many developpers seem to like this tool.
• Sandcastle – (Microsoft/Visual Studio specific) maybe try this tutorial
• Makedoc
• CppDoc
• Natural Docs
• CoolDoc
• CAA C++ (IBM)

Additionally, you could check this list, from the Python Doc SIG (the list covers many doclet tools for several languages)

And finally, I also discovered, in passing, a quizzical, documentation oriented to programming ‘literate programming’  – this page provides an introduction.