使用Doxygen生成libevent document

libevent自己是不提供在线下载的文档的,用户可以自己去http://libevent.org/在线查看,如最新的文档是2.0.15:http://www.wangafu.net/~nickm/libevent-2.0/doxygen/html/
    但是,在线文档毕竟没有离线的看起来舒服和方便,下面我教大家如何制作自己的离线document,以后的每个版本就可以自己制作省的去问google和baidu了:
    一、工具准备
    1. 首先下载下你要制作的那个版本对应的lievent源代码,现在最新的是2.0.15,ok,那我们就做个这个版本的文档吧,去下载:
    https://github.com/downloads/libevent/libevent/libevent-2.0.15-stable.tar.gz
    2. 制作libevent文档我们需要doxygen工具和Windows Help Workshop 1.32,对应下载地址:
        doxygen 1.7.5.1:
        http://heze.onlinedown.net:82/down/doxygen-1.7.5.1-setup.zip
        Windows Help Workshop 1.32:
        http://download.microsoft.com/download/0/a/9/0a939ef6-e31c-430f-a3df-dfae7960d564/htmlhelp.exe
    二、制作
    安装好doxygen和Windows Help Workshop后,我们就可以开始了:
    1. 设置project

    1>. Doxygen 工作目录,存放配置文件的目录---我就放在我的安装目录了
    2>. 设置工程名字---我们要做的是libevent-2.0.15,所以就设置为了libevent-2.0.15
    3>. 我们的代码存放位置---我把libevent-2.0.15放在了D:/workspace/libevent-2.0.15-stable
    4>. 是否要递归扫描子目录---勾上
    5>. 生成的文档存放路径---设置为d:/libevent_doc
    2. 设置Mode:

    1>. libevent是C写的,所以我们选择C++ output
    3. 设置output

    1>. 是否生成CHM文档---勾上
    2>. 是否生成PDF文档---去掉
    4. 设置Diagrams:

    1>. 使用内置的diagram生成器
    2>. 使用GraphViz工具来生成diagram--- 如果你要生成专业点的diagram就勾上,并且安装GraphViz
    5. 设置Input的文件类型:

   1>. 设置要扫描的文件类型,C/C++的就可以了,可以把.JAVA或.py去掉
   6. 设置设置CHM相关属性:

    1>. 设置生成的CHM文件名字
    2>. 设置CHM工具的路径---我的是:D:/Program Files (x86)/HTML Help Workshop/hhc.exe
    7. OK,可以build的了:

    1>. 点击 run doxygen
    8. CHM文档生成了:D:\libevent_doc\html\lbevent-2.0.15.chm

    是不是跟网站上的在线文档一样?;-)

原文地址:https://www.cnblogs.com/UnGeek/p/2985783.html