标签：
http://blog.csdn.net/lostaway/article/details/6446786
Doxygen 是一个支持 C/C++，以及其它多种语言的跨平台文档生成工具。如同 JavaDoc, doxygen 直接从源文件中提取符合 doxygen 注释规范的注释，生成文档[1]。
地址：ftp://ftp.stack.nl/pub/users/dimitri/doxygen-1.7.4.windows.bin.zip
地址：http://www.graphviz.org/pub/graphviz/stable/windows/graphviz-2.28.0.msi
graphviz 是一个由AT&T实验室启动的开源工具包，用于绘制DOT语言脚本描述的图形[2]。Doxygen 使用 graphviz 自动生成类之间和文件之间的调用关系图，如不需要此功能可不安装该工具包。
地址：http://download.microsoft.com/download/0/a/9/0a939ef6-e31c-430f-a3df-dfae7960d564/htmlhelp.exe
这个工具就不多说了，生成 CHM 帮助文档的。 Doxygen 使用它生成 CHM 格式的文档。
Doxygen 1.7.4 主界面如下图 1 所示。
说明：
Doxygen 工作目录(1:) 就是用来存放配置文件的目录，别无它用。
相关配置说明如下图 2 所示。
相关配置说明如下图 3 所示。
如果之前安装了 Graphviz 工具包，就可启用该选项。
相关配置说明如下图 4 所示。
说明：编码格式，UTF-8 是首选。
相关配置说明如下图 5 所示。
说明：
输入的源文件的编码，要与源文件的编码格式相同。如果源文件不是UTF-8编码最好转一下。
相关配置说明如下图 6 所示。
说明：
如果在 Wizard 的 Output Topics 中选择了 prepare for compressed HTML (.chm)选项，此处就会要求选择 hhc.exe 程序的位置。在 windows help workshop 安装目录下可以找到 hhc.exe。
在 Expert 标签中还有超多的选项，需要按自己的要求去定制。个人喜好问题就不再赘述了，大家可以查 doxygen 文档啥的，里面有每个选项的详细介绍。
相关配置说明如下图 7 所示。
点击 Run doxygen 按钮， Doxygen 就会从源代码中抓取符合规范的注释生成你定制的格式的文档。接下来的工作就是学习 doxygen 的注释规范了，参考 《doxygen 快速入门》第 2 节 “常用注释语法”。慢慢的就可以体会到 doxygen 的方便性。
由于 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 快速入门
补充几张效果图：
标签：
原文地址：http://www.cnblogs.com/andy1202go/p/5459701.html
