I use DISTRIBUTE_GROUP_DOC with enumerations as follows:

enum Foo 
{
    ReferenceValueId = 0,                               //!< A baseline value
    //@{
    //! Required value.
    SomeValueId,
    SomeOtherValueId,
    AnotherValueId,
    //@} 
    //@{
    //! Optional value.
    AnOptionalValueId,
    AnotherOptionalValueId,
    ...
    //@} 
}

In previous versions (1.6.1 for sure) this resulted in the descriptions getting automatically copied for each of the individual enum values. This no longer works in version 1.7.1. Only the value that has the documentation blurb gets included in the documentation (i.e. SomeValueID and AnOptionalValueID in the example above).