用doxygen风格注释代码生成文档

目录

• 用doxygen风格注释代码生成文档
  • 1. 说明
  • 2. 具体操做
    • 2.1 生成头部注释
    • 2.2 安装doxygen
    • 2.3 工程配置
  • 3. 总结

用doxygen风格注释代码生成文档

1. 说明

目前由代码生成文档的方式将使项目变得简单，同时生成的文档也会将与代码同步起来。要注意文档的规范性，因此能够采用doxygen自动生成文档。下面经过操做对文档的注释进行一下总结。

2. 具体操做

由于咱们用的vscode的，能够下载Doxygen Documentation Generator插件。

当安装上插件后能够进行使用了。

2.1 生成头部注释

生成头部注释很简单

便会自动出现下面的注释

注释函数咱们也能够采用这种方式

/**
 * @file testdoxygen.c
 * @author your name (you@domain.com)
 * @brief 
 * @version 0.1
 * @date 2019-01-23
 * 
 * @copyright Copyright (c) 2019
 * 
 */

#include "stdio.h"

/**
 * @brief 测试文件1
 * 
 */
void test1(void)
{
    
}

/**
 * @brief 测试第二个例子
 * 
 * @param a 
 * @param b 
 * @return int 
 */
int test2(int a,int b)
{
    return a+b;
}

/**
 * @brief 测试第三个例子
 * 
 * @return true 
 * @return false 
 */
bool test3(void)
{
    return false;
}

该代码编写完成后就能够用doxygen生成代码说明了。

2.2 安装doxygen

下载连接：http://www.doxygen.nl/

下载完成就能够点击安装了，下一步，下一步直接安装，安装完成就能够直接打开进行查看。

2.3 工程配置

打开后就能够配置工程了

设置代码抽取及优化模式

设置输入

设置配图方案

生成文档

生成后能够看到html文件夹和rtf文件夹

打开html文件夹进入index.html

这样就生成了工程代码的描述文档。

3. 总结

写代码的时候必定要规范，因此在写代码的过程当中，必定须要添加注释，按照doxygen风格生成的注释，能够给他人查阅，而且调用相关的api便可进行使用。这是一个很是好的习惯，软件工程师值得好好学习。