c - Doxygen:在数组创建时警告文件结尾

Question

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

几乎所有 doxygen 编译都可以工作，除了我需要一些非常大的静态数组。我不想让主代码变得困惑，所以我使用了在这些论坛上找到的 hack (https://stackoverflow.com/a/4645515/6776259):

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 会感到困惑。这也可能会破坏其他文件的文档生成，即使它们看起来不相关。通常这会导致符号丢失和 broken callgraphs .