Doxygen 包括一行@brief 评论后的斜杠

Question

我正在使用长斜杠来记录我的代码，以使它们在代码中脱颖而出。

//////////////////////////////////////////////////////////////////////
/// @brief This is a simple test struct.
//////////////////////////////////////////////////////////////////////
struct Foo
{
  //////////////////////////////////////////////////////////////////////
  /// @brief Function with single line brief to demonstrate issue.
  //////////////////////////////////////////////////////////////////////
  void a() {}
};

我从一个全新的 subversion checkout 构建了 doxygen，当它在每个块末尾的斜线行上方的代码上运行时，它包含在简要说明中。该问题在我系统上安装的 doxygen 1.8.1 中不存在，因此这似乎是 doxygen 主干中的错误。

我已将错误 700345 提交给 doxygen 项目，但我有兴趣尝试自己修复此问题。

我无法找到 doxygen 用于检测注释块结尾的代码。有没有人有使用这部分代码的经验并有时间为我指出正确的方向？

仅供参考，一个快速的解决方案是在@brief 之后添加一个空白注释行。我对通过大约 100k 行代码来识别有问题的注释块并添加一个空行（还）不感兴趣。

Answer 1

请参阅您提交的错误报告所附的我提出的修复建议。