使用doxygen来从源码产生文档

使用doxygen来从源码产生文档

Doxygen 是从带注释的 C++ 源代码生成文档的事实上的标准工具，但它也支持其他流行的编程语言，
如 C、Objective-C、C#、PHP、Java、Python、IDL（Corba、Microsoft 和 UNO/OpenOffice 风格） ),Fortran、VHDL
以及在某种程度上D.

选择HTML，勾选GENERATE_HTMLHELP,选择HHC_LOCATION为
C:Program Files (x86)HTML Help Workshop下的hhc.exe
如果GENERATE_HTMLHELP 标记设置为 YES，则 doxygen 生成三个额外的 HTML 索引文件：index.hhp、index.hhc 和 index.hhk。
index.hhp 是一个项目文件(project file)。
HTML Help Workshop 包含一个编译器，即hhc.exe(html help compiler)可以将 doxygen 生成的所有 HTML 输出转换
为单个编译的 HTML 文件 (.chm)。编译后的 HTML 文件现在用作 Windows 98 帮助格式，并将在未来所有 Windows
平台上替换旧的 Windows 帮助格式 (.hlp)。
压缩的 HTML 文件还包含索引、目录，您可以在文档中搜索单词。

1.hhp文件，这是最常用的一类文件，它实际上是“HTML Help project”的缩写，表示HTML帮助文件项目，它是生成CHM文件最直接用到的一类文件，
  只需要有一个hhp文件就可以根据它来编译相应的CHM文件。 

2.hhc文件，它是“HTML Help table of contents”的缩写，表示的是HTML帮助文件的目录，通常我们在
CHM文件浏览器的左边窗口中看到的目录内容就由它来提供，当然，它并不能直接被编译成CHM文件，而先要集成到某一hhp文件中才能发挥作用。 

3.hhk文件，它是“HTML Help Index Keyword”的缩写，为我们提供了CHM文件的关键字索引查询功能，
也是一个易于查看的帮助文件不可缺少的一部分，同hhc文件一样，它也不能直接编译生成相应的CHM文件。 

在HTML输出文件夹下即可看到chm类型(chm是compiled HTML file )的文件