忽略一些註釋

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有這個簡單的開關，但是，您可以在Doxygen運行之前編寫自己的INPUT_FILTER程序來清理文件（例如通過刪除註釋）。

Answer 2

我注意到並測試一個doxygen的註釋中的HTML註釋將被忽略：

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

至於&不被轉義，你注意到\ &會逃呢？也許這是該部分的解決方案。