实用工具推荐----Doxygen使用方法

1 软件介绍

2 Doxygen软件下载方法

3 Doxygen软件配置方法

4 标准注释描述

4.1 块注释和特殊描述字符

4.1.1 函数描述示例

4.1.2结构体数组变量示例

特别注意：

4.2单行注释

4.2.1 单个变量注释示例

特别注意：

4.2.2对于枚举变量描述示例

4.3 markdown语法使用及效果

4.4 类图 & 流程图调用关系生成方法

1 软件介绍

Doxygen是通过注释过的源代码文件来生成文档的工具，常用的语言例如C、Objective-C、C#、PHP、Java、Python、IDL等。它可以从一组有文档的源文件生成在线文档浏览器（HTML格式）和/或离线参考手册（LaTeX格式）。它还支持生成 RTF（MS-Word）、PostScript、超链接 PDF、压缩 HTML、DocBook 和 Unix 手册页的输出。文档直接从源代码中提取，这使得保持文档与源代码的一致性变得更加容易。可以配置 Doxygen 从未文档化的源文件中提取代码结构。这对于在大型源代码分发中快速找到方向非常有用。Doxygen 还可以通过包含依赖图、继承图和协作图来可视化各个元素之间的关系，所有这些都会自动生成。

Doxygen是开源软件，遵循GUN开源协议，因此生成的文档是从其生产中使用的输入派生的衍生作品;他们不受此许可证的影响。

开源Github网址：GitHub - doxygen/doxygen: Official doxygen git repository

Doxygen官网：Doxygen homepage

2 Doxygen软件下载方法

软件下载网站参照官网：Doxygen download

可以在不同系统上下载不同版本安装包，默认安装即可。

3 Doxygen软件配置方法

安装后在安装目录下可以看到 doxygen\bin\doxywizard.exe 程序

点击打开后可以看到运对应的GUI界面

首先填写 Project信息

然后填写模式信息

选择输出文档模式

关于生成类图的选项

选择 Expert 可以配置更多内容，例如在input中可以追加中文源码分析，鼠标悬停在各个选项上时有更详细的解释

上述内容配置好后，可以点击file或者ctrl+s保存配置。开发上各个域或模块情况不一样，每部分作业可以按照自己的需求定制化配置进行保存，开发者导入配置文件后标准化注释后直接导出文件即可。

进入Run界面，点击Run doxygen开始生成相关文档，点击 Show HTML output，可以查看生成的文档内容

4 标准注释描述

4.1 块注释和特殊描述字符

标准注释方法可以参照官方文档中Special Commands章节

下载连接：https://www.doxygen.nl/files/doxygen_manual-1.12.0.pdf.zip

常用的commands例如

commonds	含义
brief	函数简要说明
copyright	版权所有声明
author	作者描述
data	日期描述
version	版本描述
param	参数描述
showdata	版本日期描述
return	返回值描述
note	注解提示信息
important	重要提示信息
code \endcode	示例代码
warning	警告提示信息
todo	代办事项提示信息
bug	Bug提示信息