Doxygen：在数组创建的组内警告文件结束

Question

此问题是由于 doxygen 解析限制造成的。我在 Kinetis Design Studio 中使用 doxygen 1.8.11 和 Eclox（eclipse 插件）进行嵌入式 C 开发。

几乎所有的 doxygen 编译都有效，除了我需要一些非常大的静态数组。我不想弄乱主要代码，所以我使用了在这些论坛上找到的 hack ():

static const float Large_Array[2000] = {
#include "Comma_Delimited_Text_File.txt"
};

不幸的是，那个 hack 导致我的 main.c main_module 组的编译失败。出现以下错误：

警告：在组内文件结束

我已经尝试从我的 main_module 组中排除这些常量，如下所示：

/*!
**  @addtogroup main_module
**  @{
*/
...
... header code ...
...
/*!
** @}
*/
static const float Large_Array[2000] = {
#include "Comma_Delimited_Text_File.txt"
};
/*!
**  @addtogroup main_module
**  @{
*/
...
More code, definitions, etc.
None of this is generated in the doxygen compile...?
/*!
** @}
*/

这消除了 doxygen 编译错误，但是编译后的 doxygen 文档在 Large_Array 声明之后不包含任何内容。所以似乎第二个 @addtogroup 语句不起作用。

我是不是漏掉了一些简单的东西？任何帮助表示赞赏。谢谢。

Answer 1

如果 Comma_Delimited_Text_File.txt 没有尾随换行符，请尝试添加一个。

如果包含文件不以换行符结尾，Doxygen 会感到困惑。这也可能会破坏其他文件的文档生成，即使它们看起来并不相关。这通常会导致丢失符号和 .

Doxygen：在数组创建的组内警告文件结束

Doxygen: warning end of file while inside a group from array creation

c

doxygen

doxygen-addtogroup