Doxygen最后一个枚举成员未记录

Question

我有一个枚举，该枚举使用成员分组来一次设置组中的所有成员值。

这是代码：

/** 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;

但是没有记录该枚举的最后一个成员（ MPTag_RollAngle ）。

我将DISTRIBUTE_GROUP_DOC设置为true

您可以在此处看到html输出

更新：

该错误已修复：

• 提交： 在此处输入链接描述
• 错误跟踪器： 在此处输入链接描述

Answer 1

您只需在最后一个enum元素上添加尾随逗号即可自动记录该元素：

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

---

“添加逗号确实可以，但是我不认为这是最终的解决方案。这是否意味着它是Doxygen错误？”

好吧，那当然可以认为是Doxygen解析器的一个错误。
但是我个人还是喜欢这种风格（说实话：我在滥用它是为了使复制行和编辑变得更容易，在编写代码时应将其视为强烈不鼓励的行为）。