Question

Is it possible to group function parameters in Doxygen documentation so that I don’t have to duplicate the comment? For example I want something like:

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

Doxygen output:

<...>
Parameters:

  a,b - <long documentation>

Answer 1

Yes, you can just pass a comma separated list of parameters with @param, like so:

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

And it will appear in the output as you would expect.