Question

Is it possible to document a group of enum values, similar to this (this example doesn’t work):

enum MyEnum
{
  MYENUM_FIRST,
//@{
//@name These two members' description
  MYENUM_SECOND,
  MYENUM_THIRD,
//@}

  MYENUM_FOURTH, ///third member documentation
  MYENUM_FIFTH
};

Answer 1

Two immediate things which stand out:

• You are not documenting MYENUM_SECOND or MYENUM_THIRD since you have not wrapped them with valid doxygen comments: your should write ///@{ instead of //@{.

• Your documentation of MYENUM_FOURTH should be

  ///< third member documentation
  

  otherwise you are documenting MYENUM_FIFTH instead of MYENUM_FOURTH.

I could get documentation for both MYENUM_SECOND and MYENUM_THIRD by using the following code

enum MyEnum
{
  MYENUM_FIRST,
  ///@{
  /// These two members' description
  MYENUM_SECOND,
  MYENUM_THIRD,
  ///@}

  MYENUM_FOURTH, ///< third member documentation
  MYENUM_FIFTH
};

and by setting DISTRIBUTE_GROUP_DOC = YES in the configuration file. Note that I have removed the \name command from your example.