我如何告诉 doxygen 一个函数是“自我记录”的？答案

【问题标题】：How do I tell doxygen a function is "self-documenting"?我如何告诉 doxygen 一个函数是“自我记录”的？
【发布时间】：2019-05-15 10:36:05
【问题描述】：

我在我的 (C++) 项目中使用 Doxygen。

我有一些不言自明的功能，我不想添加任何评论或解释 - 但我确实希望作为文档的一部分出现。现在，如果我不编写 /** */ 块，这确实会作为 doxygen 的默认行为发生，但是 - 我在 Doxygen 的输出中收到警告：

warning: Member foo() of namespace bar is not documented.

我如何告诉 doxygen 没有此类功能的文档也没关系？

附加信息：

【问题讨论】：

【解决方案1】：

Doxygen 希望查看它显示的所有功能的文档，所以无论如何你都必须做点什么。

最好有一个空命令，例如：

ALIASES = selfdocumenting="&nbsp;"

所以你可以写例如：

/// @selfdocumenting
void fie2(void);

【讨论】：