代码之家  ›  专栏  ›  技术社区  ›  Dr Deo

滑稽的评论- C++

  •  8
  • Dr Deo  · 技术社区  · 15 年前

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

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

    问题
    1.它们是什么?(我在学习C++时没有提到)
    2.他们有文件吗(在哪里)

    2 回复  |  直到 14 年前
        1
  •  16
  •   Yacoby    15 年前

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

        2
  •  7
  •   Carl Norum    15 年前

    这些是为一些风味的自动文档生成器。另一个程序在代码中运行,查找您在代码中看到的注释。这个 @... 关键字标识文档应该如何布局,该程序直接从源代码生成漂亮的HTML或打印文档。这是一种让文档更容易更新代码的方法。