有趣的评论 - c ++

Question

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

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

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

Answer 1

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

Answer 2

这些是自动文档生成器的一些风格.另一个程序运行代码,寻找你在那里看到的评论.的@...关键字标识的文件应如何进行布局,并且程序直接从源代码生成相当HTML或打印的文档.这是一种让文档更容易与代码保持同步的方法.