C++ doxygen一次注释多个变量

如果我有以下资料：

/**
 * @brief (x,y,z) points for block
 */
int x, y, z;

它只会为x生成文档，在doxygen中是否可以让它用一条注释注释所有x、y和z

编辑 根据envu的建议，我现在有以下内容（基于）

或

然而，这两个仍然只是文档x。

---

尝试使用不同的形式我还没有得到相同的文档字符串来跨越多个变量

我将使用成员组。语法和输出与您想要实现的有点不同，但我认为这不会有什么坏处。

我意识到这是一个老问题，但我也遇到了类似的问题，并找到了一种解决方法，它不能完全解决问题，但在某些情况下可能是一种可以接受的替代方法

通过将注释放在成员组块上方，并在其前面加上

\name

装饰符，可以得到一个描述，该描述显示在Doxygen页面属性列表中成员组中所有变量的上方。我相信这是一个简短的描述，但是如果你愿意的话，你可以在这里任意地写长的描述

这不会对成员组中的每个变量在细节字段中添加相同的注释（细节字段将为空，或者如果在成员组块中添加注释，它仍将仅应用于第一个变量），但它确实具有将相关变量组记录在一起的效果，这似乎是问题的初衷

例如：

/*! \name This will be the description for the following group of variables
          It can be arbitrarily long, but the first line will show up in bold,
          and any subsequent lines will show up like a description under it
*/
//@{
int relatedVariable1;
int relatedVariable2;
char* relatedVariable3;
//@}

---

我在这上面撞了一阵子。原来您必须在配置中设置

DISTRIBUTE\u GROUP\u DOC=YES

。

我在“专家”选项卡中设置了“DISTRIBUTE\u GROUP\u DOC”选项。小组的所有成员都收到了相同的评论

//@{
/** same comment for all members */
char aaa;
char bbb;
int ccc;
//@}

---

谢谢你的帖子，我还是无法让它工作。请查看我的更新帖子，了解我的尝试。是的，它将只记录

x

。不幸的是，编写

intx；int y，z似乎也不起作用。可能是提交了一个bug？没有比这更好的东西了，这可能是doxygen或其文档中的bug。@cjh我在成员函数组中也遇到了同样的问题。我想这是一只虫子。
/*! \name This will be the description for the following group of variables
          It can be arbitrarily long, but the first line will show up in bold,
          and any subsequent lines will show up like a description under it
*/
//@{
int relatedVariable1;
int relatedVariable2;
char* relatedVariable3;
//@}

//@{
/** same comment for all members */
char aaa;
char bbb;
int ccc;
//@}