comments - Doxygen @file 删除了除@brief 之外的其他命令格式

Question

如果我有带有 doxygen 注释的 ac 头文件：

/*!
*    @file    MyHeaderFile.h
*    @brief   Brief header file description
*    @author  Me Myself
*    @date    2012.4.16
*/  

这导致像这样的html：

同样的语法在函数注释中也能正常工作：

我做错了什么还是这一切都受支持？

编辑：正常功能评论：

/*!
*    @brief This function does things
*
*    @author Me Myself
*    @date   2012.4.16
*   
*    @returns    void
*/
void MyFunctionThing(void)
{
}

Answer 1

尽管给定您的示例，我无法真正重现该问题，但这很可能是 Markdown 支持（在 1.8.0 版中引入）的结果，尤其是代码块功能。您可以尝试避免/解决此问题的选项：

• 在配置文件中将 MARKDOWN_SUPPORT 设置为 NO
• 缩进评论块中的文本，空格少于 4 个（在 之后*）。