Doxygen 常规使用
2009-10-25 12:19
253 查看
Doxygen官网地址:http://www.doxygen.org/
使用指南:http://www.stack.nl/~dimitri/doxygen/doxywizard_usage.html
下载地址:http://www.stack.nl/~dimitri/doxygen/download.html#latestsrc
Linux i386 --
doxygen-1.5.9.linux.bin.tar.gz
Windows 95/98/ME/NT/2000/XP/Vista --
doxygen-1.5.9-setup.exe
步骤1 :下载doxygen的binary 包
doxygen下载地址:Doxygen官网
为了使doxygen能够将类图、协作图等 加入到文档中,还要下载安装graphviz for win。
graphviz 下载:
Liunx Redhat 版本下载:http://www.graphviz.org/Download_linux_rhel.php
windows
版本
下载:
http://www.graphviz.org/Download_windows.php
全部安装后就可以开始使用了。
步骤2:运行doxygen wizard.exe
通过图形界面运行doxygen,在doxygen的bin目录中运行doxywizard.exe,这时按照doxygen根目录下的文档(doxygen_manual-1.5.2.chm)中 Doxywizard usage一节的说明设置即可。主要包括,源码路径、工作路径、输出路径等。
步骤3:点开始,即可生成文档
最后对文档生成过程中遇到的一些问题进行说明:
1.中文问题:中文注释在文档中是乱码。
解决:在expert中的INPUT选项页的INPUT_ENCODEING中填入“GB2312”,这样基于GB的文本编辑器生成的代码就可以正常使用了。
2.图形问题:无法绘制类图协作图等图形。
解决:首先确保安装了graphviz for win,
注意不是wingraphviz,后者是一个graphviz的com封装,但是doxygen并不是基于它开发的,所以装了也没用。然后在expert
的DOT_PATH中填入graphviz的安装路径。接着在wizard的diagram中选择需要生成的图形类别就可以了。
如果出现无法包含.map文件的错误,可以将工作目录设置成html,并将html中所有文件都清除再试。这个问题的原因还不太确定。
3.输出chm的问题:如何输出.chm文件
在expert中的HTML页:选中“GENERATE_HTMLHELP”,然后在CHM_FILE中填上想要的chm文件名。
HHC_LOCATION中输入hhc.exe文件的路径。hhc.exe可以通过安装HTML Help Workshop获得。
HTML Help Workshop 地址:
http://www.microsoft.com/downloads/details.aspx?FamilyID=00535334-c8a6-452f-9aa0-d597d16580cc&displaylang=en
这样,基本上就能够用doxygen生成漂亮的文档了。代码方面,doxygen支持多种格式的注释风格,根据manual选择自己喜欢的就好。
使用指南:http://www.stack.nl/~dimitri/doxygen/doxywizard_usage.html
下载地址:http://www.stack.nl/~dimitri/doxygen/download.html#latestsrc
Linux i386 --
doxygen-1.5.9.linux.bin.tar.gz
Windows 95/98/ME/NT/2000/XP/Vista --
doxygen-1.5.9-setup.exe
步骤1 :下载doxygen的binary 包
doxygen下载地址:Doxygen官网
为了使doxygen能够将类图、协作图等 加入到文档中,还要下载安装graphviz for win。
graphviz 下载:
Liunx Redhat 版本下载:http://www.graphviz.org/Download_linux_rhel.php
windows
版本
下载:
http://www.graphviz.org/Download_windows.php
全部安装后就可以开始使用了。
步骤2:运行doxygen wizard.exe
通过图形界面运行doxygen,在doxygen的bin目录中运行doxywizard.exe,这时按照doxygen根目录下的文档(doxygen_manual-1.5.2.chm)中 Doxywizard usage一节的说明设置即可。主要包括,源码路径、工作路径、输出路径等。
步骤3:点开始,即可生成文档
最后对文档生成过程中遇到的一些问题进行说明:
1.中文问题:中文注释在文档中是乱码。
解决:在expert中的INPUT选项页的INPUT_ENCODEING中填入“GB2312”,这样基于GB的文本编辑器生成的代码就可以正常使用了。
2.图形问题:无法绘制类图协作图等图形。
解决:首先确保安装了graphviz for win,
注意不是wingraphviz,后者是一个graphviz的com封装,但是doxygen并不是基于它开发的,所以装了也没用。然后在expert
的DOT_PATH中填入graphviz的安装路径。接着在wizard的diagram中选择需要生成的图形类别就可以了。
如果出现无法包含.map文件的错误,可以将工作目录设置成html,并将html中所有文件都清除再试。这个问题的原因还不太确定。
3.输出chm的问题:如何输出.chm文件
在expert中的HTML页:选中“GENERATE_HTMLHELP”,然后在CHM_FILE中填上想要的chm文件名。
HHC_LOCATION中输入hhc.exe文件的路径。hhc.exe可以通过安装HTML Help Workshop获得。
HTML Help Workshop 地址:
http://www.microsoft.com/downloads/details.aspx?FamilyID=00535334-c8a6-452f-9aa0-d597d16580cc&displaylang=en
这样,基本上就能够用doxygen生成漂亮的文档了。代码方面,doxygen支持多种格式的注释风格,根据manual选择自己喜欢的就好。
相关文章推荐
- doxygen简单使用
- 不使用常规方法求1+2+···+n
- Windows下使用doxygen阅读和分析C/C++代码
- html学习第一讲(内容html常规控件的的使用)
- Doxygen使用学习(二)------Doxygen的内部支持的markdown语法
- c标签forEach和c标签if的常规使用
- VBA控件常规使用--multiPage 控件
- [C] c99int(让VC等编译器自动兼容C99的整数类型)V1.02。源码托管到github、添加CMake编译配置文件、使用doxygen规范注释
- Javascript中Array常规使用方法
- 使用Xcode HeaderDoc和Doxygen文档化你的Objective-C和Swift代码
- 使用Xcode HeaderDoc和Doxygen文档化你的Objective-C和Swift代码
- OD常规使用方法总结
- Doxygen学习和使用心得
- SpringMVC上传图片总结(1)---常规方法进行图片上传,使用了MultipartFile、MultipartHttpServletRequest
- 使用jQuery插件创建常规模态窗口登陆效果
- DrawableLayout(导航抽屉效果)使用遇到的几个常规网上资源未提到的部分
- grid.常规使用
- 使用doxygen为C/C++程序生成中文文档
- Git特点和Git常规命令使用总结
- MFC常规DLL的创建与使用实例