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

Question

我将 Doxygen 用于我的 (C++) 项目。

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

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

我如何告诉 doxygen 没有此类功能的文档是可以的？

附加信息：

• 我有EXTRACT_ALL = NO
• 我在 Devuan ASCII (~= Debian Stretch) 上使用 Doxygen 1.8.13

Answer 1

Doxygen 希望查看它显示的所有功能的文档，因此无论如何您都必须做一些事情。

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

ALIASES = selfdocumenting=" "

所以你可以写例如：

/// @selfdocumenting
void fie2(void);