c++ - Doxygen - pdf 中模块的顺序错误

Question

我使用 doxygen 创建了一个文档，并使用 @defgroup 和 @ingroup 指令将模块组织成组。现在我的层次结构如下:

Source1.h
/// @defgroup MainGroup This is the main group

Source2.h
/// @ingroup MainGroup
/// @defgroup SubGroup1 This is a subgroup

Source3.h
/// @ingroup MainGroup
/// @defgroup SubGroup2 This is another subgroup

Source4.h
/// @ingroup SubGroup2
/// @defgroup SubSubGroup ...

问题是，在生成 PDF 时，模块索引的页码顺序错误，并且组不遵循层次结构，例如

MainGroup......................5
SubSubGroup....................20
SubGroup1......................10
SubGroup2......................15

虽然我想要一些东西

MainGroup......................5
SubGroup1......................10
SubGroup2......................15
SubSubGroup....................20

生成 latex 文档后，我总是必须手动重新排序 refman.tex 文件中的\include 指令。

有什么方法可以修复此行为并让 doxygen 以正确的顺序生成模块索引和组吗？

Answer 1

通常，当我遇到此类问题时，我必须在 Doxyfile INPUT 语句中以明确的顺序列出源文件，而不是使用通配符或仅使用文件夹名称。

INPUT = Source1.h Source2.h Source3.h Source4.h