> In short, the fault of doxygen is that it's not designed in close integration with the language parser to ensure a highly correct understanding of source code...

I'm fairly certain that doxygen uses libclang[0] for a correct parse of the code these days. 0: http://clang-developers.42468.n3.nabble.com/Doxygen-1-8-4-us...