文件头部模板

// +----------------------------------------------------------------------
// | 项目名称 [ 文档功能简要描述 ]
// +----------------------------------------------------------------------
// | Copyright (c) 2016-2016 版权 All rights reserved.
// +----------------------------------------------------------------------
// +----------------------------------------------------------------------
// | Author: Chenjl 
// +----------------------------------------------------------------------

函数/方法头部注释

/**
 * 函数/方法作用描述
 * 
 * @access  public 
 * @version 0.0.1
 * @Author  Chenjl  * 
 * @return  mixed | void
 */

程序代码注释

  1. 注释的原则是将问题解释清楚,并不是越多越好。

  2. 若干语句作为一个逻辑代码块,这个块的注释使用:/* */方式。

  3. 具体到某一个语句的注释,可以使用行尾注释://。