doxygen 常用语法

1. 头文件

//CommonType.h
/**
 * @file        CommonType.h
 * @brief       define common type
 * @details     file details content
 * @author      LikeShadows
 * @date        2018.09.06
 * @version     V1.0
 * @copyright   LikeShadows
 */
 ```
 ## 2. 全局变量
 ```
 /**
 * 4-octet type
 */
 typedef unsigned int UINT;


 /**
 * struct coordinate system
 */ 
typedef struct {
    UINT x;     ///< x-coordinate
    UINT y;     ///< y-coordinate
}Coordinate;


/**
 * enum type
 */
enum COLOR {
    RED = 0,     ///< red color
    GREEN,       ///< green color
    YELLOW,      ///< yellow color
    BLUE,        ///< blue color
};


/**
 * Macro define 
 */
#define NULL    0
 ```

## 3. 函数声明

/**
*
* @param[in] fileNameLen file name len
* @param[in] fileName file name
* @param[out] fileData file content data
* @return 0: OK, !0: Fail
* @retval UINT
* @see main.c
* @remarks remark content
* @exception exception error
* @warning warning info
* @bug bug details
* @pre pre conditions, e.g input param type or vaule
* @post aft conditions, e.g system state changed
* @note fileName must be not Null
*/
UINT WriteFile(UINT fileNameLen, BYTE *fileName, BYTE *fileData);
“`

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值