有趣的评论 - c ++

Question

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

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

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

Answer 1

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

Answer 2

这些是自动文档生成器的一些风格。另一个程序运行代码，寻找你在那里看到的评论。 @...关键字标识了文档的布局方式，该程序直接从源代码生成漂亮的HTML或印刷文档。这是一种让文档更容易与代码保持同步的方法。