doxygen将头文件生成html文档
来源:互联网 发布:网络通信代维招聘 编辑:程序博客网 时间:2024/05/16 06:10
前段时间公司里做项目要求遵循doxygen文档规范,并且在Windows XP下安装了Doxygen 1.8.4版本,使用起来能查看头文件是否遵循doxygen规范和一些简单的错误,另外还可以根据C或者C++源代码生成对应的API文档,尤其是生成html格式的话就更方便了。
比如说想查找dbus、glib等源代码的相关API文档,可以使用doxygen工具将下载的开源软件的源代码生成对应的API文档。
doxygen也有linux的开源版本,下载地址如下:http://sourceforge.net/projects/doxygen/
doxygen的网址:http://www.stack.nl/~dimitri/doxygen/index.html
http://www.doxygen.org/
关于doxygen的介绍:
Doxygen是一种开源跨平台的,以类似JavaDoc风格描述的文档系统,完全支持C、C++、Java、Objective-C和IDL语言,部分支持PHP、C#。注释的语法与Qt-Doc、KDoc和JavaDoc兼容。Doxgen可以从一套归档源文件开始,生成HTML格式的在线类浏览器,或离线的LATEX、RTF参考手册。
一、在Ubuntu12.04下使用apt-get install命令即可安装doxygen命令行工具和相应的GUI工具,命令如下:
sudo apt-get install doxygen
sudo apt-get install doxygen-gui
安装之后在/usr/bin目录下有关于doxygen的三个命令工具:
doxygen(命令行工具)
doxytag
doxywizard(GUI向导工具)
二、在Ubuntu12.04下使用doxygen将下载好的源代码生成API文档。
1、以从blfs网站下载源代码D-Bus-1.6.10,链接为:http://dbus.freedesktop.org/releases/dbus/dbus-1.6.10.tar.gz,这个网站有很多现成的linux常用软件。
2、Ctrl+Alt+T打开终端,输入doxywizard,会弹出如下的doxygen GUI界面,这个使用起来和Windows XP下使用的doxygen差不多。
2、将刚下载的dbus-1.6.10.tar.gz解压缩
进入dbus-1.6.10.tar.gz下载所在目录,使用如下命令解压:
tar -xzvf dbus-1.6.10.tar.gz
或者选择dbus-1.6.10.tar.gz点击右键,选择【Extract here】即可。
3、配置dbus工程的选项,例如:doxygen脚本配置文件存放路径、doxygen API文档存放路径、工程名、版本号等信息。
在工作目录,例如/home/ccf/Downloads下创建tmp目录存放doxygen脚本配置文件,创建dbus-html-docs目录用于存放输出的dbus API文档,另外将解压缩后的dbus-1.6.10源代码也移动到此目录下,在第1步弹出的doxygen gui界面中进行如下配置:
从上面的配置可以看出:
doxygen API配置脚本存放路径为:/home/ccf/Downloads/tmp
工程名称为:dbus
版本号为:1.6.10
源代码所在目录为:/home/ccf/Downloads/dbus-1.6.10
doxygen API文档输出路径:/home/ccf/Downloads/dbus-html-docs
另外,注意上面的【Scan recursively】单选框一定要选上,否则生成不了对应的doxygen API文档- doxygen将头文件生成html文档
- 使用doxygen生成头文件函数说明文档/帮助文档
- 使用 doxygen 生成文档
- doxygen生成word文档
- doxygen 生成文档
- doxygen 生成文档
- Doxygen生成文档注释
- 使用doxygen生成文档
- doxygen 生成源码文档
- Doxygen生成注释文档
- Doxygen生成注释文档
- doxygen生成PDF文档
- Doxygen生成C文档的做法(附有文件)
- 用 Doxygen 自动生成文档
- doxygen --文档自动生成工具
- 用 doxygen 生成源码文档
- 用 doxygen 生成源码文档
- 源代码文档生成工具----Doxygen
- javascript原型链
- Java读取txt文件编码格式
- 2016/5/11
- 浅析Alljoyn中设备的发现和连接
- Spark MLlib 机器学习算法与源码解析(网络课程—第一期)
- doxygen将头文件生成html文档
- 1.python基础学习__函数中的参数
- Android程序优化之对屏幕旋转的处理总结
- OneThink修改后台文档列表搜索规则
- java 前端及后台轮询方法总结
- poj 1703 Find them, Catch them
- 【C语言】动态内存分配alloca
- UVa 712 S-Trees(满二叉树数组保存与编号)
- g4l 备份还原linux系统