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
- Natural Docs
- 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.