c++ - Doxygen:是否可以对 C++ 函数参数进行分组，即具有相同的文档而不复制它？

Question

是否可以在 Doxygen 文档中对函数参数进行分组，这样我就不必重复注释了？例如我想要这样的东西:

/**
  <...>
  @param {{a, b}} <long documentation>
*/

氧气输出:

<...>
Parameters:

  a,b - <long documentation>

Answer 1

是的，您可以使用@param 传递逗号分隔的参数列表，如下所示:

/** Sets the object's position.
 *  @param x,y,z Coordinates of the position in 3D space.
 */
void setPosition(double x,double y,double z)
{
}

它会如您所料出现在输出中。