c中的doxygen:定义的分组

我用doxygen记录C代码。 为了使文档更具可读性,我想至少使用@defgroup和@ingroup将每个.c / .h文件对中的代码添加到一个组中。 在这些组中,我想使用@name块将一些定义组合在一起。

“文件”页面中的结果与我的预期密切相关:文件中记录的所有内容都列在那里,或多或少地很好地分组。 另一方面,在“模块”页面中,仅列出函数和变量,并在第一个@name块之前的定义列在“变量”下。 缺少所有其他定义和枚举。 删除@name块列出“variables”下的所有定义/ typedefs / enums。 没有自己的宏或枚举部分,也没有在这些页面上进一步分组。

如何在模块/组页面上列出的组中获取所有定义和枚举,例如在文档页面上记录定义/function等?

我使用doxygen 1.8.9.1 windows binarires。

我的代码看起来类似于:.h文件:

/** @file * blabla * @author bla */ /// @ingroup MY_GRP /// @{ #define SOMEDEF1 1 /// @name Special defs /// @{ #define SOMEDEF2 2 /// @} enum someenum { foo, bar }; extern int some_variables; extern void some_proc(int baz); /// @} 

.c文件看起来像这样:

 /** @file * blabla * @author bla */ /** @defgroup MY_GRP A test group. * Description */ /// @{ #include "my.h" /// Important variable. int some_variable; /** Important proc * Description * @param baz need this */ void some_proc(int baz) { // code } /// @} 

我让doxygen wizzard生成一个doxyfile并生成一个DoxygenLayout.xml文件。 当使用布局文件播放arround时,我发现组页面上的“定义”标签是空的(它们显然什么都不做),而变量部分中的“定义”是由“membergroups”标签生成的……不要知道如何做到这一点。

任何帮助深表感谢。 如果您需要doxyfile或其他任何让我知道。

可以使用@addtogroup标记将文件的所有成员添加到组中。

这里已经回答了同样的问题: Doxygen:文件成员是否可以inheritance模块分组,如果它们在一个分组的文件中?