1

I have an enum that uses member grouping to set the members values all at once in a group.

Here is the code :

/** MP format tags
 *
 * See the DC-007_E Specification.
 * 5.2.2.3  Table 3, page 13
 */
typedef enum
{
    /*MP Index IFD*/


    ///@{
    ///Mandatory
    MPTag_MPFVersion        = 0xB000,
    MPTag_NumberOfImages    = 0xB001,
    MPTag_MPEntry           = 0xB002,
    ///@}


    ///@{
    ///Optional
    //TODO : implement those tags
    MPTag_ImageUIDList      = 0xB003,
    MPTag_TotalFrames       = 0xB004,
    ///@}

    ///@{
    ///Individual image tags (attributes)
    MPTag_IndividualNum     = 0xb101,
    MPTag_PanOrientation    = 0xb201,
    MPTag_PanOverlapH       = 0xb202,
    MPTag_PanOverlapV       = 0xb203,
    MPTag_BaseViewpointNum  = 0xb204,
    MPTag_ConvergenceAngle  = 0xb205,
    MPTag_BaselineLength    = 0xb206,
    MPTag_VerticalDivergence= 0xb207,
    MPTag_AxisDistanceX     = 0xb208,
    MPTag_AxisDistanceY     = 0xb209,
    MPTag_AxisDistanceZ     = 0xb20a,
    MPTag_YawAngle          = 0xb20b,
    MPTag_PitchAngle        = 0xb20c,
    MPTag_RollAngle         = 0xb20d

    ///@}
}MPExt_MPTags;

But the last member of the enum (MPTag_RollAngle) isn't documented.

I set the DISTRIBUTE_GROUP_DOC to true

You can see the html output here

Update :

The bug has been fixed :

Community
  • 1
  • 1
Lectem
  • 503
  • 6
  • 19

1 Answers1

0

You just add a trailing comma to that last enum element to get it auto documented:

typedef enum  {
    // ...
    MPTag_RollAngle = 0xb20d, // <<< add trailing comma
};

"adding a comma does work, but I don't think it is a final solution. Would it mean it is a Doxygen bug ?"

Well, that could be that could be considered a bug of the doxygen parser of course.
But I personally prefer this style anyway (to be honest: I'm abusing that to make copying lines and editing easier, which should be considered a strongly discouraged behavior when writing code).

πάντα ῥεῖ
  • 1
  • 13
  • 116
  • 190
  • 1
    Approved since it's working and that there is probably no other solution. For future reference, the bug as been reported https://bugzilla.gnome.org/show_bug.cgi?id=746226 – Lectem Mar 15 '15 at 00:22
  • Not working here any more (Fedora 21 up to date). I wanted to *hide* the last member and with or without comma it's documented anyway. – moorray Mar 19 '15 at 17:16
  • @moorray May be it was fixed in your doxygen version meanwhile. [This post](http://stackoverflow.com/questions/1619577/how-can-doxygen-exclude-a-c-class) shows a technique how you can actually hide any elements from being documented. – πάντα ῥεῖ Mar 19 '15 at 17:17