使用doxygen生成chm

    终于成功的使用doxygen生成chm文档了，发了两天时间，头都痛了。深刻的教训：要学好英文！
      doxygen使用文档：《 使用DOXYGEN生成CHM帮助文档 使用详解 》

      出现的几个问题：
      1、在程序注释中画示意图，但是doxygen会将多行作为details进行合成一行，完全打乱了视觉效果，尝试若干总不行，终于没办法读他自带的英文帮助文档，找到\verbatim 和 \endverbatim ，解决问题。效果如下：

 

      2、在为函数写注释时，doxygen有时没有将 \param 或 \return正确处理，怎么修改都没用，最后全删了重新写，注意在中文前后留空格，解决问题。猜测是中文解析的时候导致doxygen产生混乱、

      3、最严重的一个问题，就是生成的chm文档没有导航栏！而doxygen的日志上没有什么异常，自己用HTML Help WorkShop编译，产生错误：
HHC6000: Error: An internal file could not be created. Make certain there is enough disk space on the drive where you are compiling your file. 
HHC5007: Error: Fatal navigational compilation error. This is likely the result of an invalid contents (.hhc) file.
绞尽脑汁，没有进展。发英雄帖也没回应。由百度转到google，读了一些英文贴，但是自己的英语太差，找不出想要的信息。最后，终于很偶然的找到救星： 《制作 CHM 时出现 HHC6000 和 HHC5007 错误的解决办法》：“

后来还是靠着 Google 的强大威力找了个英文的帖子，看了半天总结出一句话，重新注册一下 itircl.dll ，这个文件在 C:\WINDOWS\system32\ 目录下，具体方法如下

打开命令行（在 “运行” 里面输入 “cmd”）

用 cd 命令进入以上文件夹

输入 regsvr32 itircl.dll

回车后会提示注册成功，然后再编译 CHM 文件就OK了，以上错误都没有了。