有趣的评论 - C++

Question

当我阅读开源项目的源文件时，我经常在 cmets 中遇到一些奇怪的短语

/*       
@brief ......  
@usage.....  
@remarks....  
@par....  
*/

问题
1.它们是什么？（我在学习c++时没有提到）
2.他们有任何文件吗（在哪里）

Answer 1

它们只是 cmets，因此在 C++ 中没有特殊含义。他们可能会允许文档生成器（例如Doxygen）从 cmets 中提取数据。

Answer 2

这些是一些自动文档生成器的味道。另一个程序运行代码，寻找与您在此处看到的类似的 cmets。 @... 关键字标识文档的布局方式，该程序直接从源代码生成漂亮的 HTML 或打印文档。这是一种更轻松地使文档与代码保持同步的方法。