标签: java c++
当我们在Java中使用/ ** * / comment样式时,它有@param的那些注释, 或@ num1,这使得阅读评论更容易,并消除了可能出现的歧义。例如,如果您想在评论中引用num1,则可以通过编写@num1颜色更改,并且您知道评论引用参数num1,但是如果您说{{} 1}},参数的颜色保持不变,难以阅读,可能与另一个具有相同名称的变量混淆。这只是一个例子。
num1
@num1
Java风格:
答案 0 :(得分:6)
它与语言本身无关,但有文档生成程序可以理解“Javadoc”样式注释。
例如Doxygen。
答案 1 :(得分:5)
C ++标准没有定义任何注释语义,如Java与Javadocs一样。
但有一些扩展程序,例如doxygen,cldoc或DOC++,它们提供类似的功能。
检查您的IDE /文本编辑器是否支持doxygen语法高亮显示。
答案 2 :(得分:1)
C ++没有为这些评论提供处理器,但它们确实存在。我13年前用过一个。我认为它被称为...... cppdoc,但不要引用我。
cppdoc