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输出here

更新：

错误已修复：

• 提交：enter link description here
• 错误跟踪器：enter link description here

Answer 1

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

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

---

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

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