doxygen 是一个代码文档生成器,不过功能上还算不错,目前对中文支持也是很好。 1. 首先从http://www.stack.nl/~dimitri/doxygen/ 下载一份最新的源程序,如果是源码包,那么用tar 打开./configure->make ->make install,那么就安装好了,如果是debian用户,现在源里面已经有,可以直接apt安装 2. 安装好后可以先看看他的文档,有比较详细的说明,一般linux用户在/usr/share/doc/doxygen 下面,里面还有一个example,这个比较不多,可以看多很的例子。 3. doxygen 使用也是非常的简单,首先 doxygen -g file(file 为配置文件,如果没有指定 那么它会自动给你生成一个 Doxyfile) . 4. 之后就是对配置文件的修改了,具体的修改可以看它的Doc,这里说几个比较重要的 PROJECT_NAME 项目名称 RECURSIVE =YES 设置是否递归 PROJECT_NUMBER 项目版本 EXCLUDE =dir pattern 排除的目录 OUTPUT_DIRECTORY =dir 输出的目录 INLINE_SOURCES =yes 会显示源码 OUTPUT_LANGUAGE= 输出的语言 目前支持很多 中文也支持 EXTRACT_ALL = YES 的话将包括的文件都分析 INPUT =dir 出入的目录 FILE_PATTERNS =*.c *.h *.cpp .... 分析的文件后缀 还有其他一些,可以看文档 5. 代码的注释,以及一些命令,一般和javadoc 相似, @author @param @date @file @sa 等等 6. 写好后运行 doxygen -s file 就可以了 7. doxygen可以生成各种格式的文档 除了 html 还有 man latex rtf , 而且也支持数学公式的生成,以及图片的生成 如类关系图 |
doxygen简单使用
最新推荐文章于 2024-05-03 17:55:21 发布