Doxygen生成美丽注释文档：初体验

Posted 2021-01-25 yqmcu

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Doxygen生成美丽注释文档：初体验相关的知识，希望对你有一定的参考价值。

Hello Doxygen

[TOC]

Chapter 1 - 准备工作 (Windows环境)

1.1 程序包下载

Doxygen

源码： git clone https://github.com/doxygen/doxygen.git
GUI版本：点击下载
便携压缩包版本：下载 32位版本 64位版本

html Help Workshop

用于生成CHM文件，便于传播和查看。

Htmlhelp.exe

Graphviz

用于绘制DOT语言标本描述的图形。Doxygen 使用 graphviz 自动生成类之间和文件之间的调用关系图。

Sublime + DoxyDoxygen 插件

1.2 安装教程

Chapter 2 - 初尝 Doxygen

2.1 为源代码生成文档大致分为两个步骤：

为源代码编写符合 doxygen 要求的注释
使用 doxygenwizard 生成文档

2.2 编写 Doxygen 注释

/**< 标准输入输出头文件 */
#include <stdio.h>

/**
 * @brief      { Calculate the sum of two doubles }
 *
 * This function will return the sum of two doubles
 *
 * @param[in]  a     { the first number }
 * @param[in]  b     { the second number }
 *
 * @return  double   {  the sum of a and b  }
 */
double add(double a,double b)
{

    return a+b;
}

/**
 * @brief      { Calculate the different of two doubles }
 * 
 * This function will return the different of two doubles
 * 
 * @param[in]  a     { the first number }
 * @param[in]  b     { the second number }
 *
 * @return  double   { the different of a and b }
 */
double subtract(double a,double b)
{
    return a-b;
}

/**
 * @brief      { Calculate the product of two doubles }
 * 
 * This function will return the product of two doubles
 *
 * @param[in]  a     { the first number }
 * @param[in]  b     { the second number }
 *
 * @return  double   { the product of a and b }
 */
double multiply(double a,double b)
{
    return a*b;
}

/**
 * @brief      { Calculate the quotient of two doubles }
 * 
 * This function will return the quotient of two doubles
 * 
 * @param[in]  a     { the first number }
 * @param[in]  b     { the second number }
 *
 * @return  double   { the quotient of a and b }
 */
double divide(double a,double b)
{
    return a/b;
}

/**
 * @brief      { This is the main function }
 *
 * This function is the main function. 
 * It will print something in the screen.
 * 
 * @return  int   { The exit code. }
 */
int main(void)
{
    int a = 5,b = 6;
    printf("%lf
",add(a,b));
    printf("%lf
",subtract(a,b));
    printf("%lf
",multiply(a,b));
    printf("%lf
",divide(a,b));

    return 0;
}