忽略一些评论

Question

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

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

这会导致doxygen为具有name的struct生成输出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有一个简单的开关,但是,你可以在doxygen运行之前编写自己的INPUT_FILTER程序来清理文件(例如通过删除注释).