使用带有 doxygen 的 lint 注释

Question

对于文档，我们通常必须创建一个额外的文档，描述在代码中禁用任何 lint 消息时我们所做的事情(eg /* lint --e228) 。 将它与doxygen一起使用会更容易（因为我们无论如何都会创建它）。

尽管如此，我无法找到有关如何使用这些lint注释制作doxygen任何解决方案。 有人试过这个吗？ 有什么解决方案如何使用stric '/*lint'但无论如何将它添加到doxygen吗？

谢谢！

Answer 1

这可以通过定义一个宏来扩展为 lint 表达式注释来实现，但是当被doxygen扩展时，让宏扩展为不同的注释。

诀窍是使用-save指令到 PC-lint ^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 注释来触发 lint 控制。 该技术在Gimpel 软件讨论论坛上有描述。 （此链接似乎已失效，新的讨论论坛似乎不再包含引用的讨论。）

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