Doxygen基本使用教程

前言

规范的注释是一个良好的编程习惯。

Doxygen可以直接将注释提取为程序文档，便于开发人员使用

本文主要介绍了Doxygen的使用方法，更多细节请阅读官方文档

---

一、Doxygen是什么？

doxygen是一个文档生成工具，用于为源码生成文档，我们可以在代码中按照doxygen要求的语法编写代码注释，然后使用doxygen将程序中的注释提取出来生成一个文档

我们一般都把注释写在代码中，所以使用doxygen生成的文档也可以非常方便地更新。Doxygen还会在文档中引用源码文件，故我们也可以在文档中方便地查看源码

二、Doxygen的安装

1.windows

下载软件.软件安装过程基本无脑下一步

2.Linux

(1).使用命令安装

sudo apt-get install doxygen
sudo apt-get install doxygen-gui

(2).使用源码安装

下载压缩包：如doxyen-1.11.0.src.tar.gz

tar zxvf doxyen-1.11.0.src.tar.gz
cd  doxyen-1.11.0
./configure
make
sudo make install

(3).安装Graphviz和HTML Help Workshop(可选)

Doxygen 使用HTML Help Workshop可以生成 CHM 格式的文档

Graphviz在Doxygen用于自动生成类图的工具。

官网：Graphviz和HTML Help Workshop

注：记住安装路径，配置到Doxygen中

三、DoxygenHTML HELP的使用

1.配置Wizard

注：工作目录和源文件目录一般保持一致

2.配置Expert

3.运行

四、Doxygen语法

1.特殊命令

命令	字段名	语法
@file	文件名	file [< name >]
@brief	简介	brief
@author	作者	author
@mainpage	主页信息	mainpage [(title)]
@date	年-月-日	date
@author	版本号	version
@copyright	版权	copyright
@param	参数	param [(dir)] < parameter-name>
@return	返回	return { description of the return value }
@retval	返回值	retval
@bug	漏洞	bug
@details	细节	details
@pre	前提条件	pre { description of the precondition }
@post	说明代码项之后的使用条件
@see	参考	see
@link	连接(与@see类库，{@link www.google.com})	link < link-object>
@throw	异常描述	throw < exception-object>
@exception	对一个异常对象进行注释
@todo	待处理	todo
@warning	警告信息	warning
@example	弃用说明。可用于描述替代方案，预期寿命等	deprecated
@deprecated	弃用说明。可用于描述替代方案，预期寿命等	deprecated
@code	在注释中开始说明一段代码，直到@endcode命令
@endcode	注释中代码段的结束
@since	通常用来说明从什么版本、时间写此部分代码。
@attention	注意

2.注释风格

(1).文件注释

注：位于文件开头

/**
 * @file 文件名
 * @brief 简介
 * @details 细节
 * @author 作者
 * @version 版本号
 * @date 年-月-日
 * @copyright 版权
 */

(2).函数注释

 /**
  * @brief 函数描述
  * @param 参数描述
  * @return 返回描述
  * @retval 返回值描述
  */

(3).常量/变量注释

一般常量/变量可以有两种形式：

• 常量/变量上一行注释
• 常量/变量后注释

``///定义一个变量
int a;

int a; ///< 定义一个变量

​