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

Question

我有一个相当笼统的问题：我最近在 C/C++ 代码中看到了许多 #defines，它们被注释为“/*

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

我个人只在 cmets 中看到了定义，而在 Google 中的搜索也没有回答我的问题。这有什么意义吗？这只是常见的做法还是来自 Doxygen？还是有其他原因？

Answer 1

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

来自 Doxygen 文档的 "Putting documentation after members" 部分的示例：

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

---

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