What kind of tools do you use for documenting your (c++) software ?
Up to now, I've been using Doxygen, but I have several gripes with it. In particular, the documentation it generates IMHO is somewhat ugly and bloated, especially for some of the smaller-scale projects I was involved in recently.
I've already tried around with the user-provideable stylesheet, but it just improves things slightly - font sizes and those "My-First-Homepage"-like section buttons, mainly.
* There still are unnecessary back-indices of (member -> class or file), with one index page for each letter, and like 5 entries on each of these.
* I can't disable automatic link generation - which is a problem if you have got a namespace that has the same name as your project: You get backlinks all over the place, which you then need to manually suppress. I'd rather always tag classes when I actually want to have a link to these.
* ... and several more annoyances I just don't want to completely list.
I've already looked through the list of alternatives on the Doxygen homepage, but neither of these looks too promising - some of them aren't even in development anymore...
Perhaps I'm a bit spoiled by the niceties and cleanness of JavaDoc... but surely, there must be some viable alternative for C++ ? What other tools do you have experience in ? What customizing do you do to the Doxygen output ?
Thank you for your time,