Objective c Doxygen命令@file中断类描述部分的生成

@file命令中断了doxygen生成的HTML文档中描述部分的生成

/**
 @file Class.h

 @brief Brief desc.

 Description text.
*/

在Class.h的输出中，未生成任何描述部分。因此，文本“简要说明”和“说明文本”不会显示

/**
 Class.h

 @brief Brief desc.

 Description text.
*/

将按预期生成描述部分

由于我想记录全局typdefs，@file命令是必需的

---

配置中是否有任何参数强制生成描述？

找到了缺少的信息

通过添加@file commmand（正如文档中提到的那样），文件被记录下来

这意味着doxygen将在“文件”选项卡中为该头文件创建一个额外的文档，并在通常的“类”选项卡中创建一个

如果没有@文件，则只会生成“类”中的文件。在这种情况下（没有@文件），初始注释和Objective Cs@接口上方的注释将被解释为类的组合描述

如果存在@file命令，则初始注释将用于文件描述，该文件位于“文件”选项卡中

---

只有在@interface行正上方提供注释时，类的说明才可用。

找到了缺少的信息

通过添加@file commmand（正如文档中提到的那样），文件被记录下来

这意味着doxygen将在“文件”选项卡中为该头文件创建一个额外的文档，并在通常的“类”选项卡中创建一个

如果没有@文件，则只会生成“类”中的文件。在这种情况下（没有@文件），初始注释和Objective Cs@接口上方的注释将被解释为类的组合描述

如果存在@file命令，则初始注释将用于文件描述，该文件位于“文件”选项卡中

只有在@interface行的正上方提供注释时，类的描述才可用