doxygen: how do I document \enum values out-of-line?

Question

To be precise: I know how to dox enums at the point of declaration, I want to dox them out-of-line instead.

I want to keep the header file free of doxygen comments; they're all in the .cpp file. This is not a problem for functions, classes, typedefs and so on. I can also document the enum itself like this:

/*!
  \enum MyClass::MyEnum

  Foo Bar Baz

  \value FirstEnumValue <- doesn't work
*/

but how do I document the values of the enum there?

Thanks!

Answer 1

You need to use \var according to the docs

Answer 2

I think you have to use something along the lines of

/*!
  \enum MyClass::MyEnum

  Foo Bar Baz

  \var MyClass::MyEnum::FirstEnumValue Description
 */

but I've never used this as I find that keeping the comments near the code increases maintainability, so the format might not be quite right.

See here.