C 叮当声不响'；我不知道Doxygens retval标签

我试图编译一个带有clang 3.6和

-Weverything

的C文件，但在我的Doxygen注释中失败，该注释包含

\retval

标记

我的代码如下所示：

/***************************************************************************/
/** Main Function.
 *
 * This function represents the main functionality.
 *
 * \retval 0 successful
 * \retval other failed
 */
int main(
    int argc,                               /**< argument count */
    char **argv                             /**< argument list */
)
{
    ...
    return 0;
}

---

我知道我可以通过提供

-Wno documentation unknown命令来禁用警告，但我认为这不是最好的解决方案。
如评论所述，您可以使用以下选项：

-fcomment-block-commands=retval

这将阻止clang抱怨标记\retval。
这是唯一明智的解决方案。或者禁用-Weverything.虽然我支持启用大量额外警告，坦率地说，
-Weverything
远远超出了需要。或者您可以手动将这些命令添加到clang…尝试使用-fcomment block命令手动指定retval如果您没有发现实际问题
-Werror-Weverything
通常毫无意义，因为它实际上打开了所有可用的诊断——其中许多不是关于代码问题的警告，而是类似这样的东西或与优化相关的信息。
-fcomment-block-commands=retval