我正在寻找一种方法来抑制关于未记录的成员函数的doxygen警告,但不使用 //! @cond
和 //! @endcond
,所以成员函数仍然出现在类的概要中。类似于以下内容:
class Foo
{
public:
Foo();
Foo(const Foo&);
Foo& operator=(const Foo&);
};
这些成员函数显而易见并且不需要文档,但我仍然希望它们出现在文档中的可用成员函数列表中(因为知道类是可复制/可赋值的事务)。因此,doxygen会针对这些中的每一个发出“未记录”警告。如果我使用 //! @cond
和 //! @endcond
,这些方法完全从文档中消失。我想要的是方法在文档中保持可见,但没有任何进一步的评论,我希望氧气不要抱怨它们没有记录。
是否有某种“虚拟评论”告诉doxygen关闭缺乏doc,但仍然保留文档中的方法,所以它们是可见的?