doxygen - 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

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