The Clang 3.2 release notes (via Clark Goble): Clang now supports documentation comments written in a Doxygen-like syntax. Clang parses the comments and can detect syntactic and semantic errors in comments. These warnings are off by default. Pass -Wdocumentation flag to enable warnings about documentation comments.