Comments should be Doxygen-compatible in headers. I.e they should be on the line preceding the attribute and be of the form "/// \brief My comment here..."