doxygen - 如何摆脱奇怪的 doxygen 警告

Question

当在一个包含许多文件（我认为所有文件都完整记录）的特定相当大的 C 语言项目上运行doxygen时，我总是在输出的底部找到这个警告：

<@1>:1: warning: parameters of member @1 are not (all) documented

如何找到并删除此警告的触发器？

请注意，对于二分法或其他基于试错法的搜索方法，所讨论的项目太大（而且问题不够重要）。

Answer 1

意识到这是一个老问题，但我自己也遇到了这种行为，并没有在网上找到解决方案。

通过运行 Doxygen 并查看错误消息出现在输出中的位置找到了有问题的文件（确保您没有抑制标准输出，否则您只会在没有上下文的情况下得到错误）。

在我的情况下，错误出现在“为组 [name] 生成依赖关系图”行之后。通过查看相关文件，我发现了一个未记录的、未命名的枚举。枚举的成员仍然被记录在案。例如

enum
{
    X = 1, /**< Documented. */
    ...
}

我猜这是抛出 Doxygen 并导致无用消息的枚举上缺少名称。添加名称会导致生成更多有用的错误消息。记录枚举（带或不带名称）可消除错误。