Consider checking Doxygen comments at compile time

[bbannier]

Even though we currently do not render Doxygen output, we still try to document some interfaces with it. We should consider validating that these comments are correct, e.g., by adding -Wdocumentation to the compiler flags if compiling with Clang.