C++注释

1. 文件注释
/**
 * @file         Test.cpp
 * @author       张三
 * @version      0.1
 * @date         20090928
 * @brief        日期处理类
 * @details      对日期包装的处理
 * 
 * @history
 */

2. 类注释
/** 
 * @class        CTest
 * @brief        日期处理类
 *
 * @details      对日期包装的处理
 */
class CTest{
};

3. 函数注释
/**
 * @brief        求阶乘
 * @param[in]    r 传入的待求阶乘的数
 * @param[out]   s 返回的阶乘数值
 * @return       0，成功；-1，失败
 */