doxygen的安装和基本使用可参考:Doxygen的安装和基本使用
doxygen的所有选项的参考文档:doxygen官网文档
例如:
2、修改样式
注释可以参考官方文档:doxygen官方注释
/**
* ... text ...
*/
Qt 风格
/*!
* ... text ...
*/
C++ 注释块
///
/// ... text ...
///
或者
//!
//!... text ...
//!
/**
* @file 文件名(*.h/*.c)
* @brief 该模块功能的简介。
* @details 使用该模块有哪些细节注意等。
* @author 创建该文件的人名。
* @data 该文件的创建日期(2020-03-10)。
* @version 文件当前的版本号(V1.0.0)。
* @copyright 版权所属公司。
*/
/**
* @fn 函数名
* @brief 简述函数功能。
* @details 提示一些注意事项或必要的技术细节。
* @param[in] 参数名 参数注解
* @param[out] 参数名 参数注解
* @param[in, out] 参数名 参数注解
* @return None (宏函数无返回值)
* @retval 对返回值的说明
* @see 扇入:调用了该函数的上级函数(扇入高表示该函数复用性好)
* @see 扇出:该函数里调用了哪些下级函数(扇出高表示该函数复杂度高)
* @note 注解。
* @attention 注意事项。
* @par example:
* @code
//代码示例
* @endcode
*/
/**
* @def 宏函数名
* @brief 简述函数功能。
* @details 提示一些注意事项或必要的技术细节。
* @param[in] 参数名 参数注解
* @param[out] 参数名 参数注解
* @param[in, out] 参数名 参数注解
* @return None (宏函数无返回值)
* @see 扇入:调用了该函数的上级函数(扇入高表示该函数复用性好)
* @see 扇出:该函数里调用了哪些下级函数(扇出高表示该函数复杂度高)
* @note 注解。
* @attention 注意事项。
* @par example:
* @code
//代码示例
* @endcode
*/
#define MAX //!< 最大值
Byte g_byMax = 0; //!< 全局变量,最大值
/**
* @enum 枚举名
* @brief 简介枚举用途。
* @details 提示一些注意事项或必要的技术细节。
* @note 注解。
* @attention 注意事项。
*/
/**
* @union 联合名
* @brief 简介联合用途。
* @details 提示一些注意事项或必要的技术细节。
* @note 注解。
* @attention 注意事项。
*/
/**
* @struct 结构体名
* @brief 简介结构体用途。
* @details 提示一些注意事项或必要的技术细节。
* @note 注解。
* @attention 注意事项。
*/
原文地址:https://blog.csdn.net/louxiaofei_java/article/details/129266245
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如若转载,请注明出处:http://www.7code.cn/show_9583.html
如若内容造成侵权/违法违规/事实不符,请联系代码007邮箱:suwngjj01@126.com进行投诉反馈,一经查实,立即删除!