Doxygen 忽略一些评论

我正在处理一些遗留代码，为此我使用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;
}

//@brief有关此结构的信息，请参阅：
结构
{
int i；
}

doxygen生成的输出不是有效的XML，因为链接中的

&

未正确转义

---

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

我不认为doxygen有一个简单的切换，但是，您可以在doxygen运行之前编写自己的程序来清理文件（例如，剥离注释）。

我注意到并测试了doxygen注释中的html注释将被忽略：

///@brief some comment here <--! ignored here --> also continues over.

//@这里的一些评论也在继续。

---

至于不被逃脱，你有没有注意到会逃脱？也许这是该部分的解决方案。

如果您将其更改为：##@简短的评论也会继续。