c++ - 为什么 Doxygen 文档只出现在多个相邻组的最后一个？

Question

我正在尝试使用 Doxygen 组同时记录几个类似的函数。我希望函数共享示例中所示的相同文档 here .

// @{
//! @brief Some documentation
int func1(void);
int func2(void);
// @}

// @{
//! @brief Some other documentation
int func3(void);
int func4(void);
// @}

但是，当我运行 doxygen 时，只有第二组 在 HTML 输出中显示 @brief 消息。我做错了什么，或者这是一个潜在的错误？

请注意，我不是试图嵌套组，doxygen 文档说这是不允许的。

Answer 1

为了这对你有用 need to have在您的配置中启用 DISTRIBUTE_GROUP_DOC。代码指定为:

//@{
//! Same documentation for both members. Details ...
void func1InGroup1();
void func2InGroup1();
//@}

如果你想命名分组部分:

//! @name Group name
//@{
//! Same documentation for both members. Details ...
void func1InGroup1();
void func2InGroup1();
//@}