http://blog.csdn.net/lostaway/article/details/6446786
Doxygen 是一个支持 C/C++，以及其它多种语言的跨平台文档生成工具。如同 JavaDoc, doxygen 直接从源文件中提取符合 doxygen 注释规范的注释，生成文档[1]。
1、安装
1.1 安装 Doxygen 1.7.4(Windows)
地址：ftp://ftp.stack.nl/pub/users/dimitri/doxygen-1.7.4.windows.bin.zip
1.2 安装 graphviz 2.28.0(Windows)
地址：http://www.graphviz.org/pub/graphviz/stable/windows/graphviz-2.28.0.msi
graphviz 是一个由AT&T实验室启动的开源工具包，用于绘制DOT语言脚本描述的图形[2]。Doxygen 使用 graphviz 自动生成类之间和文件之间的调用关系图，如不需要此功能可不安装该工具包。
1.3 安装 Windows Help Workshop 1.32
地址：http://download.microsoft.com/download/0/a/9/0a939ef6-e31c-430f-a3df-dfae7960d564/htmlhelp.exe
这个工具就不多说了，生成 CHM 帮助文档的。 Doxygen 使用它生成 CHM 格式的文档。
2、配置
运行 Doxywizard 开始配置
Doxygen 1.7.4 主界面如下图 1 所示。
说明：
Doxygen 工作目录(1:) 就是用来存放配置文件的目录，别无它用。
选择 wizard 标签下的 Output Topics
相关配置说明如下图 2 所示。
选择 wizard 标签下的 Diagrams Topics
相关配置说明如下图 3 所示。
如果之前安装了 Graphviz 工具包，就可启用该选项。
选择 expert 标签下的 Project Topics
相关配置说明如下图 4 所示。
说明：编码格式，UTF-8 是首选。
选择 expert 标签下的 Input Topics
相关配置说明如下图 5 所示。
本文档主要讲述的是maven使用方法；Maven是基于项目对象模型的（pom），可以通过一小段描述信息来管理项目的构建，报告和文档的软件项目管理工具。Maven将你的注意力从昨夜基层转移到项目管理层。Maven项目已经能够知道 如何构建和捆绑代码，运行测试，生成文档并宿主项目网页。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看
说明：
输入的源文件的编码，要与源文件的编码格式相同。如果源文件不是UTF-8编码最好转一下。
选择 expert 标签下的 HTML Topics
相关配置说明如下图 6 所示。
说明：
如果在 Wizard 的 Output Topics 中选择了 prepare for compressed HTML (.chm)选项，此处就会要求选择 hhc.exe 程序的位置。在 windows help workshop 安装目录下可以找到 hhc.exe。
在 Expert 标签中还有超多的选项，需要按自己的要求去定制。个人喜好问题就不再赘述了，大家可以查 doxygen 文档啥的，里面有每个选项的详细介绍。
选择 Run 标签
相关配置说明如下图 7 所示。
点击 Run doxygen 按钮， Doxygen 就会从源代码中抓取符合规范的注释生成你定制的格式的文档。接下来的工作就是学习 doxygen 的注释规范了，参考 《doxygen 快速入门》第 2 节 “常用注释语法”。慢慢的就可以体会到 doxygen 的方便性。
Doxygen 生成 CHM 文档乱码的问题
由于 Windows 的默认编码不是 UTF-8， Doxygen 生成的 CHM文件目录和文件标题栏是乱码。一般解决步骤可以参考《doxygen 快速入门》关于解决目录乱码的问题。这里要补充的一点就是，最好将 index.hhc、index.hhk 、index.hhp都转为 UTF-8格式。这样标题栏啥的也不会是乱码了。
参考
[1] http://zh.wikipedia.org/wiki/Doxygen Wikipedia-doxygen
[2] http://zh.wikipedia.org/wiki/Graphviz Wikipedia-graphviz
[3] http://hi.baidu.com/soulmachine/blog/item/6055ad017a9a1606738da58c.html doxygen 快速入门
附录
补充几张效果图：
