变量后的 Doxygen 多行注释

Question

我已经用 doxygen 语法记录了一个结构。

//! This struct contains some info
typedef struct myInfo
{
    int variable1;  //!< This is a very long text about my variable. This
                    //!< is a very long text about my variable.
} myInfo;

当我生成 html/chm 输出时，变量描述包含一个“

我正在使用当前的 doxygen 1.8.11，并且我已设置 MULTILINE_CPP_IS_BRIEF = NO。

根据doxygen homepage（请参阅“将文档放在成员之后”），这应该可以工作，还是我遗漏了什么？

Answer 1

试试这个：

//! This struct contains some info
typedef struct myInfo
{
    int variable1;  /**< This is a very long text about my variable. This
                         is a very long text about my variable.*/
} myInfo;

然后你会得到一个非常“非常长”的文本。

如果您需要多行注释，请在每行末尾添加 \n。