C/C++：注释“/*< */”代表什么？

Question

我有一个相当普遍的问题：我最近在 C/C++ 代码中看到许多#defines 被注释为“/*< ... */”，例如：

#define ARRSIZE(x)          (sizeof(x)/sizeof(x[0]))        /*< macro to determine the size of an array */

我个人只在定义的评论中看到这一点，谷歌搜索也没有回答我的问题。 那有什么意义吗？ 这只是常见的做法还是来自 Doxygen？ 还是有其他原因？

Answer 1

通常， <是 Doxygen 的语法，用于在它们记录的项目之后出现的文档。

Doxygen 文档的“将文档放在成员之后”部分的示例：

int var; /**< Detailed description after the member */

---

但是，对您提供的示例感到好奇的是，它使用普通注释块 ( /* ) 而不是文档块（例如， /** ）。 我怀疑这是这个特定示例的作者的疏忽。 或者，作者可能将此约定从文档块扩展到所有性质相似的注释。