c - Doxygen 不包括 C 位域文档

Question

我在 C 程序中创建了几个伪寄存器结构，并使用结构和 union 来实现字段并将所有寄存器收集在一起。

每个成员、字段等都有文档注释，但生成的文档不显示位字段的文档...我该如何解决这个问题，以便它们的文档包含在输出中？

我的实现示例(未显示的是 bitNName 注释):

/** This shows in documentation. */
union REG1 {
    int all;            /**< This shows in documentation. */
    struct REG1BITS {
        int bit1Name:1; /**< This is not in documentation. */
        int bit2Name:1; /**< This is not in documentation. */
    } bit;              /**< This shows in documentation. */
};

/** This shows in documentation. */
union REG3 {
    int all;            /**< This shows in documentation. */
    struct REG3BITS {
        int bit1Name:1; /**< This is not in documentation. */
        int bit2Name:1; /**< This is not in documentation. */
    } bit;              /**< This shows in documentation. */
};

/** This shows in documentation. */
extern struct ALLREGS {
    union REG1 reg1Name; /**< This shows in documentation. */
    union REG1 reg2Name; /**< This shows in documentation. */
    union REG3 reg3Namd; /**< This shows in documentation. */
} CollectedRegs;

更新:我想也许这是因为包含结构的位字段都命名为位 - 这是否与 doxygen 冲突？

Answer 1

此问题已在较新版本的 doxygen 中得到修复 :)