当const在另一行处的const时,doxygen parse const成员函数不正确



我已经尝试在官方网站中搜索stackoverflow和用户邮件列表,但没有发现对我的问题有用的东西,结果有很多无关的结果...

我使用的doxygen是版本1.8.5。

我更喜欢像这样的会员函数声明样式,让我们称呼它const-at-Anthline样式。

ReturnType
FunctionName()
const;

我知道大多数人只使用全插型样式,

ReturnType FunctionName() const;

或只是返回型type-at anthline样式

ReturnType
FunctionName() const;

均适用于全插型样式和返回型在其他线样式,doxygen可以正确解析。

但是,const-at-Anther-Line样式的文档导致成员数据称为" const"和类型为returnType。

class Signal : public Interface {
    bool
    HasSignal()
    const;
};

文档显示类Signal具有公共属性

bool const

和会员数据文档中的详细文档显示

bool Signal::const

我也尝试了这些情况,纯虚拟函数:

bool
HasSignal()
const =0;

导致

bool Signal::const =0

和C 11 Final/Override关键字:(我不希望doxygen完全支持C 11语法,只是为了进行比较)

bool
HasSignal()
const
override;

导致公共属性

bool const override

哪个" const"链接到Interface类中的成员数据文档

virtual bool Interface::const = 0

和"覆盖"链接到Signal类中的成员数据文档

bool const Signal::override

我的问题是:我错过的doxygen中是否有一些配置,可以帮助解析/文档const成员函数正确使用const-At-anth-Line样式?或者我只能修改样式以适合文档目的?

看起来这是在版本1.8.6及以后的版本中修复的(请注意,版本1.8.5于2013年8月发布,因此很旧)。写作的最新版本为1.8.9.1。

最新更新