PHP 编码规范 4.1 块注释
2013-04-14 09:16
323 查看
4.1 块注释
块注释通常用于提供对文件,方法,数据结构和算法的描述。块注释被置于每个文件的开始处以及每个方法之前。它们也可以被用于其他地方,比如方法内部。在功能和方法内部的块注释应该和它们所描述的代码具有一样的缩进格式。
块注释之首应该有一个空行,用于把块注释和代码分割开来,比如:
/*
* 这里是块注释
*/
块注释可以以/*-开头,这样indent(1)就可以将之识别为一个代码块的开始,而不会重排它。
/*-
* 如果想被忽略,可是使用特别格式的块注释
*
* one
* two
* three
*/
注意:如果你不使用indent(1),就不必在代码中使用/*-,或为他人可能对你的代码运行indent(1)作让步。
块注释通常用于提供对文件,方法,数据结构和算法的描述。块注释被置于每个文件的开始处以及每个方法之前。它们也可以被用于其他地方,比如方法内部。在功能和方法内部的块注释应该和它们所描述的代码具有一样的缩进格式。
块注释之首应该有一个空行,用于把块注释和代码分割开来,比如:
/*
* 这里是块注释
*/
块注释可以以/*-开头,这样indent(1)就可以将之识别为一个代码块的开始,而不会重排它。
/*-
* 如果想被忽略,可是使用特别格式的块注释
*
* one
* two
* three
*/
注意:如果你不使用indent(1),就不必在代码中使用/*-,或为他人可能对你的代码运行indent(1)作让步。
相关文章推荐
- PHP 编码规范 3.1 开头注释
- PHP编码规范之注释和文件结构说明
- 理解学习PHP编码规范之注释和文件结构
- PHP 编码规范 4.3 尾端注释
- PHP 编码规范 4.5 文档注释
- PHP编码规范之注释和文件结构说明
- PHP编码规范(转)
- PHP Document 代码注释规范
- 团队项目开发"编码规范"之三:程序注释
- PHP编码规范说明
- PHP团队 编码规范 & 代码样式风格规范
- PHP 编码规范 5.3 布局
- 代码注释和编码规范
- Zend Framework的PHP编码规范【2】
- PHP编码规范简析
- PHPDocumentor 注释规范整理
- PHP 编码规范
- 一份比较全面的PHP开发编码规范
- PHP团队 编码规范 & 代码样式风格规范
- PHP开发编码规范