[apaprocki]

That depends.. it would be more helpful to evaluate comparing to Doxygen if a more meaty C++ example was used. This is our std::vector implementation (below). The STL provides enough meat for any doc generator to chew on...

http://bloomberg.github.com/bsl/group__bslstl__vector.html

I'm no fan of Doxygen output, but it is used because it has proven to be the most robust for documenting complicated code.

edit: links

[jevinskie]

Wow, I am green with envy after looking at those docs! I wish the LLVM/Clang doxygen was that nice. You are lucky if you get any comments at all.