1.特殊命令简介
| 命令 | 字段名 | 语法 |
|---|---|---|
| @file | 文件名 | file [< name >] |
| @brief | 简介 | brief { brief description } |
| @author | 作者 | author { list of authors } |
| @mainpage | 主页信息 | mainpage [(title)] |
| @date | 年-月-日 | date { date description } |
| @author | 版本号 | version { version number } |
| @copyright | 版权 | copyright { copyright description } |
| @param | 参数 | param [(dir)] < parameter-name> { parameter description } |
| @return | 返回 | return { description of the return value } |
| @retval | 返回值 | retval { description } |
| @node | 注解 | |
| @bug | 漏洞 | bug { bug description } |
| @details | 细节 | details { detailed description } |
| @pre | 前提条件 | pre { description of the precondition } |
| @see | 参考 | see { references } |
| @link | 连接(与@see类库，{@link http://www.google.com}) | link < link-object> |
| @throw | 异常描述 | throw < exception-object> { exception description } |
| @todo | 待处理 | todo { paragraph describing what is to be done } |
| @warning | 警告信息 | warning { warning message } |
| @deprecated | 弃用说明。可用于描述替代方案，预期寿命等 | deprecated { description } |
| @example | 弃用说明。可用于描述替代方案，预期寿命等 | deprecated { description } |
2.文件注释
一般放在文件开头
/**
* @file 文件名
* @brief 简介
* @details 细节
* @author 作者
* @version 版本号
* @date 年-月-日
* @copyright 版权
*/
示例
3.结构体注释
/**
* @brief 类的详细描述
*/
示例
4.函数注释
/**
* @brief 函数描述
* @param 参数描述
* @return 返回描述
* @retval 返回值描述
*/
实例
5.常量/变量注释
一般常量/变量可以有两种形式：
- 常量/变量上一行注释
- 常量/变量后注释
//定义一个整型变量a
int a;
/**
* @brief 定义一个整型变量a
*/
int a;
int a; /*!< 定义一个整型变量a */
int a; /**< 定义一个整型变量a */
int a; //!< 定义一个整型变量a
int a; ///< 定义一个整型变量a
