doxygen - 忽略某些评论

Question

我正在处理一些遗留代码，为此我使用 doxygen 生成 XML 文档。这种代码有两个问题。首先它包含无效的评论。例如:

///@struct E  
enum E  
{
 E1, E2, E3;  
};

这会导致 doxygen 为名称为 E 的结构生成输出，这不在代码中。我的第二个问题是 HTML 链接。例如，对于以下输入:

///@brief For info about this struct see: <a href="http://www.foo.com/bar&bar"\>  
struct S
{
  int i;
}

doxygen 生成的输出不是有效的 XML，因为链接中的 & 没有正确转义。

出于上述原因，我希望 doxygen 忽略一些评论。这可能吗？

Answer 1

我认为 doxygen 对此没有简单的开关，但是，您可以编写自己的 INPUT_FILTER在 doxygen 运行之前清理文件的程序(例如，通过删除注释)。