Doxygen注释风格

 http://www.cnblogs.com/wishma/archive/2008/07/24/1250339.html

1. /**    description    
2. *     description    
3. *     description    
4. */

5.3.2    简述与详述的方式Doxygen支持的块（类、函数、结构体等）的注释描述分为两种：简述 和 详述一般注释的描述由简述开始，经过特殊分隔方式后，后面紧跟详述的内容，javaDoc风格可以使用的分隔方法有以下两种：1）       使用 \brief 参数标识，空行作为简述和详述的间隔标识

1. /*!     @brief   Brief description.
2. *     description continued.
3. *
4. *     Detailed description starts here.
5. */

2） 直接使用javaDoc风格，javaDoc风格自动以简述开头，以空行（或者小数点加空格）作为简述与详述的分割

1. /**     Brief description
2. *     description continued
3. *
4. *     Detailed description starts here.
5. */

2. /**         Brief description
3. *          description continued . (注意:这里有一个小数点,加上一个空格)
4. *          Detailed description starts here.
5. */

5.3.3   文件头注释示例

1. //////////////////////////////////////////////////////////////////////////
2. ///     COPYRIGHT NOTICE
3. ///     Copyright (c) 2009, 华中科技大学      （版权声明）
4. ///     All rights reserved.
5. ///
6. /// @file     （本文件的文件名eg：Test.h）
7. /// @brief （本文件实现的功能的简述）
8. ///
9. ///（本文件实现的功能的详述）
10. ///
11. /// @version 1.1      （版本声明）
12. /// @author             （作者，eg：卢俊）
13. /// @date                 （文件创建日期，eg：2009年7月15日）
14. ///
15. ///
16. ///     修订说明：最初版本
17. //////////////////////////////////////////////////////////////////////////
18.   

5.3.4   类定义注释示例

1. /**     本类的功能：打印错误信息
2. *
3. *      本类是一个单件
4. *      在程序中需要进行错误信息打印的地方
5. */
6. class CPrintError
7. {
8.              ……
9. }

5.3.5   类成员变量定义示例（1）在成员变量上面加注释的格式

1. /** 成员变量描述 */
2. int   m_Var;

（2）在成员变量后面加注释的格式

1. int   m_color;     /**< 颜色变量 */     

5.3.6   成员函数的注释示例

1. /** 下面是一个含有两个参数的函数的注释说明（简述）
2. *
3. *      这里写该函数的详述信息
4. *      @param a 被测试的变量（param描述参数）
5. *      @param s 指向描述测试信息的字符串
6. *      @return     测试结果 （return描述返回值）
7. *      @see     Test()     （本函数参考其它的相关的函数，这里作一个链接）
8. *      @note     (note描述需要注意的问题)
9. */
10. int testMe(int a,const char *s);

5.3.7     枚举变量的注释示例

1. /**     颜色的枚举定义
2.    *
3.    *     该枚举定义了系统中需要用到的颜色\n
4.    *     可以使用该枚举作为系统中颜色的标识
5.    */
6. enum TEnum
7. {
8.       RED,           /**< 枚举，标识红色     */    
9.       BLUE,          /**< 枚举，标志蓝色     */    
10.       YELLOW         /**< 枚举，标志黄色. */    
11. }enumVar;