如何在不破坏Doxygen解析时抑制PC-lint的e9259警告？

问题描述 #

我有如下Doxygen风格的文档注释：

/**
 * See [datasheet][1] for details.
 *
 * [1]: https://example.com
 */
void my_func(void);

PC-lint触发警告：note 9259: C comment contains '://' sequence [MISRA 2012 Rule 3.1, required]。尝试过在问题行末尾加!e9259、lint !e9259，以及用/*lint -save -e9259*/包裹注释等方法，要么无效，要么会破坏Doxygen对函数文档的解析。

根据PC-lint手册说明：

[9259] C comment contains '://' sequence
消息9059用于报告C注释中可能包含C++注释（如'//'序列）的情况。由于在注释中包含URL是常见做法，当'//'序列前紧跟':'时，不会触发9059消息，例如：
/* See http://www.gimpel.com for details */
本消息（即9259）用于填补9059未覆盖的场景，报告此类未被9059捕获的情况。

[9059] C comment contains C++ comment
在C风格注释中发现了C++风格注释，这可能造成混淆。

可行解决方案 #

方案1：在函数声明行末尾添加局部抑制指令 #

将抑制指令放在函数声明的同一行末尾，使用/*lint !e9259*/。这样既不会破坏Doxygen对文档注释的解析（Doxygen仅解析函数上方的/** */块注释），又能让PC-lint忽略该位置的9259警告：

/**
 * See [datasheet][1] for details.
 *
 * [1]: https://example.com
 */
void my_func(void); /*lint !e9259*/

方案2：用Doxygen链接语法包裹URL #

把URL用Doxygen的尖括号链接语法包裹，PC-lint会识别这是合法的链接格式从而不触发警告，同时Doxygen仍能正常解析：

/**
 * See [datasheet][1] for details.
 *
 * [1]: <https://example.com>
 */
void my_func(void);

方案3：全局配置PC-lint忽略该警告（适合批量场景） #

如果项目中有大量此类注释，可在PC-lint的配置文件（.lnt）中添加规则，全局禁用9259警告或启用Doxygen注释识别：

-doxygen               // 让PC-lint识别Doxygen注释，自动忽略合法链接格式
-e9259                 // 全局禁用9259警告（若项目可接受全局关闭该检查）

注意事项 #

• 禁止在Doxygen的/** */块注释内部添加PC-lint指令，这会破坏Doxygen解析逻辑，同时PC-lint会报错块注释嵌套。
• 方案1是局部抑制的最优解，既不影响其他代码的警告检查，又完全兼容Doxygen。

内容的提问来源于stack exchange，提问作者beyarkay