Doxygen使用教程

2022-07-31 10:31:36 阅读：209 来源： 互联网

标签：教程 Doxygen generic 注释 file 使用 doxdocgen 模板

Doxygen 可以用来为项目生成帮助文档或者 SDK，输出格式可以为 HTML、CHM 等。

1 软件安装

2 Doxygen 注释规范

2.1 注释格式

# 块注释
/**
......
*/

# 行注释
///< ......
/** ...... */
/**< ...... */

注释命令	描述
@brief	概要信息
@details	详细描述
@par	开始一个段落，段名自定义
@param	标记参数意义
@return	描述返回意义
@retval	描述返回值意义
@todo	对将要做的事情进行注释
@bug	缺陷，链接到所有缺陷汇总的缺陷列表
@since	通常用来说明从什么版本、时间写此部分代码
@pre	用来说明代码项的前提条件
@post	用来说明代码项之后的使用条件
@code	在注释中开始说明一段代码，直到@endcode命令
@endcode	注释中代码段的结束
@fn	函数说明
@include	包含文件
@var	标注变量
@enum	标注枚举
@struct	标注结构体
@class	标注类
@note	描述一些注意事项
@addtogroup	添加到一个组

2.2 自动注释模板（VSCode settings.json 配置）

{
    // Doxygen documentation generator set
    // 文件注释：版权信息模板
    "doxdocgen.file.copyrightTag": [
        "@copyright Copyright (c) {year}  by 李云亮"
    ],
    // 文件注释：自定义模块，这里我添加一个修改日志
    "doxdocgen.file.customTag": [
        "@par 修改日志:",
        "<table>",
        "<tr><th>Date       <th>Version <th>Author  <th>Description",
        "<tr><td>{date}     <td>1.0     <td>李云亮   <td>内容",
        "</table>",
    ],
    // 文件注释的组成及其排序
    "doxdocgen.file.fileOrder": [
        "file",		// @file
        "brief",	// @brief 简介
        "author",	// 作者
        "version",	// 版本
        "date",		// 日期
        "empty",	// 空行
        "copyright",// 版权
        "empty",    // 空行
        "custom"	// 自定义
    ],
    // 下面时设置上面标签tag的具体信息
    "doxdocgen.file.fileTemplate": "@file {name}",
    "doxdocgen.file.versionTag": "@version 1.0",
    "doxdocgen.generic.authorEmail": "1144626145@qq.com",
    "doxdocgen.generic.authorName": "李云亮",
    "doxdocgen.generic.authorTag": "@author {author} ({email})",
    // 日期格式与模板
    "doxdocgen.generic.dateFormat": "YYYY-MM-DD",
    "doxdocgen.generic.dateTemplate": "@date {date}",
	
    // 根据自动生成的注释模板（目前主要体现在函数注释上）
    "doxdocgen.generic.order": [
        "brief",
        "tparam",
        "param",
        "return"
    ],
    "doxdocgen.generic.paramTemplate": "@param{indent:8}{param}{indent:25}MyParamDoc",
    "doxdocgen.generic.returnTemplate": "@return {type} ",
    "doxdocgen.generic.splitCasingSmartText": true,
    "[json]": {

        "editor.quickSuggestions": {
            "strings": true
        },
        "editor.suggest.insertMode": "replace"
    },
}

2.3 手动注释模板

2.3.1 文件注释模板

/**
 * @file 文件名
 * @brief 文件概要信息描述
 * @author 作者
 * @version 版本
 * @date 日期
 * 
 * @copyright 版权信息
 * 
 * @par 修改日志:
 * <table>
 * <tr><th>Date	 <th>Version  <th>Author  <th>Description
 * <tr><td>日期 	<td>版本     <td>作者      <td>说明
 * </table>
 */

2.3.2 函数注释模板

/**
 * @brief  函数功能概要信息
 * @param[in]  输入参数       输入参数描述信息
 * @param[out] 输出参数       输出参数描述信息
 * @return 返回类型				
 * @retval 返回值	返回值意义描述信息 
 */

3 使用教程

3.1 Doxygen Wizard Project

DoxygenWizardProject

3.2 Doxygen Wizard Mode

DoxygenWizardMode

3.3 Doxygen Wizard Output

DoxygenWizardOutput

3.4 Doxygen Wizard Diagrams

DoxygenWizardDiagrams

3.5 Doxygen Expert Project

DoxygenExpertProject

3.6 Doxygen Expert HTML

DoxygenExpertHTML

3.7 Doxygen Expert Dot

DoxygenExpertDot

4 生成效果

HTML 网页效果

CHM 文档效果

文章作者：GentleTK
原文链接：https://gentletk.gitee.io/Doxygen使用教程

标签：教程,Doxygen,generic,注释,file,使用,doxdocgen,模板
来源： https://www.cnblogs.com/gentletk/p/16536564.html

本站声明： 1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享；
2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关；
3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关；
4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除；
5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

ICode9