使用針對doxygen的lint註釋

Question

對於文檔，我們通常必須創建一個額外的文檔，描述在代碼(e.g. /* lint --e228)中禁用任何lint消息時我們所做的操作。 這將使它更容易與doxygen一起使用（因爲我們無論如何創建這個）。

雖然，我無法找到任何解決方案如何使doxygen使用這些皮棉評論。 有沒有人試過？ 有沒有解決方案如何使用stric '/*lint'但無論如何將它添加到doxygen？

謝謝！

Answer 1

這可以通過定義一個擴展到lint表達式註釋的宏來完成，但是當通過doxygen進行擴展時，使宏展開成不同的註釋。

訣竅是使用-save指令PC - 皮棉^TM或FlexeLint ^TM：

#ifndef LINT_CONTROL 
#define LINT_CONTROL(X) /*lint -save X */ //lint X 
#endif 

int main() { 
    int a; LINT_CONTROL(-e530) 
    return a != a; 
} 

然後，在你的doxygen配置文件，您可以將某些預處理宏的擴展。特別是，我們可以更改LINT_CONTROL以擴展爲doxygen-評論。

ENABLE_PREPROCESSING = YES 
MACRO_EXPANSION  = YES 
EXPAND_ONLY_PREDEF  = YES 
PREDEFINED    = "LINT_CONTROL(X)=//! lint control: X" 

或者，如果你有FlexeLint ^TM，那麼你可以修改籠罩源，使得doxygen的註釋可以用來觸發皮棉控制。該技術在Gimpel Software Discussion Forum中描述。

_{PC-lint和FlexeLint是Gimpel Software的商標。}