I'm looking for a doc tool. I really like the look and feel of Doxygen, but the last time I used it, it lacked a big feature that makes me not want to use it again.
Specifically I want to be able to consolidate overloaded functions into a single description. Similar to how this site does it:
See how it has all the overloads at the top, then a single description that covers all of them? That's a big feature I want, but don't know if/how it can be accomplished with Doxygen. Last time I had to duplicate entries for each overload (@copydoc made it easier, but still....)
Can it be done in the most recent Doxygen? Or are there any other doc tools that you guys can recommend that can do it?
I've heard from various sources that the Doxygen source has quite a big learning curve to it and is borderline messy. I think that Disch is looking for a product that will just work without having to waste time hacking around. * Don't get me wrong, Doxygen is an awesome product - in fact the best IMO.
Visual Studio has a built-in XML documentation format that might meet your requirements. There are also tools available that can parse the VS xml format and produce crisp looking docs, though I've only ever used it on managed code.
Here's a fairly comprehensive list of tools available: