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 */

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