Doxygen最后枚举成员没有记录

时间:2015-03-14 23:45:49

标签: c++ c enums doxygen

我有一个枚举,它使用成员分组在一个组中一次性设置成员值。

以下是代码:

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

更新:

错误已修复:

1 个答案:

答案 0 :(得分:0)

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

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

  

&#34;添加逗号确实有效,但我认为这不是最终解决方案。这是否意味着它是一个Doxygen bug?&#34;

那么,当然可能会被视为doxygen解析器的错误 但我个人更喜欢这种风格(说实话:我滥用它来使复制行和编辑更容易,在编写代码时应该被认为是一种强烈气馁的行为)。