[Doxygen-users] Documenting file members....

[Johan E. <joh...@ua...>]

Hi,
    I thought it was necessary to explict document the file members 
using   a structural command even if the corresponding C++ entity is 
declared immediatelly after the documentation block. For example, in 
header file foo.h:

/** \file
   * Some desc of file foo.h.....
   */

/** \enum AnEnum
   * Some desc...
   */
enum AnEnum
{
    Value0,
    Value1
};

However, in version 1.2.14 this seems not to be necessary anymore. It is 
just to do:

/** \file
   * Some desc of file foo.h.....
   */

/**
   * Some desc...
   */
enum AnEnum
{
    Value0,
    Value1
};

Is this right or is it a bug??? Personally I like the latter better, 
less to type and it is more consistent when documenting compound members.

Thanks,
        Johan