代码注释常用标签

供自己学习使用 侵删!!!

@author:作者
@class:类
@callback:回调
@constructor:类的回调函数
@classdesc:类描述
@const:常量
@default:默认值
@desc:描述
@example:举例
@name:名称:用于抽象方法或匿名函数
@param:参数
@arg:参数
@argument:参数
@property|@prop:属性
@requires:依赖
@return 返回
@type 类型


@brief	使用它来写一段你正在文档化的method, PRoperty, class, file, struct,enum的短描述信息。
@discusstion	用它来写一段详尽的描述。如果需要你可以添加换行。
@param	通过它你可以描述一个 method 或 function的参数信息。你可以使用多个这种标签。
@return	用它来制定一个 method 或 function的返回值。
@note	注意点,补充说明
@see	用它来指明其他相关的 method 或 function。你可以使用多个这种标签。
@sa	同上
@code	使用这个标签,你可以在文档当中嵌入代码段。当在Help Inspector当中查看文档时,代码通过在一个特别的盒子中用一种不同的字体来展示。始终记住在写的代码结尾处使用@endcode标签。
@remark	在写文档时,用它来强调任何关于代码的特殊之处。

@file	使用这个标签来指出你正在记录一个文件(header 文件或不是)。如果你将使用Doxygen来输出文档,那么你最好在这个标签后面紧接着写上文件名字。它是一个top level 标签。
@header	跟上面的类似,但是是在 HeaderDoc中使用。当你不使用 Doxygen时,不要使用上面的标签。
@author	用它来写下这个文件的创建者信息
@copyright	添加版权信息
@version	用它来写下这个文件的当前版本。如果在工程生命周期中版本信息有影响时这会很重要。
@class	用它来指定一个class的注释文档块的开头。它是一个top level标签,在它后面应该给出class名字
@interface	同上
@protocol	同上两个一样,只是针对protocols
@superclass	当前class的superclass
@classdesign	用这个标签来指出你为当前class使用的任何特殊设计模式(例如,你可以提到这个class是不是单例模式或者类似其它的模式)。
@coclass	与当前class合作的另外一个class的名字。
@helps	当前class帮助的class的名字。
@helper	帮助当前class的class名字。

发布了9 篇原创文章 · 获赞 14 · 访问量 1万+

猜你喜欢

转载自blog.csdn.net/Summertrainxy/article/details/104383294
今日推荐