doxygen in ubuntu linux 9.10
1, apt-get install doxygen
2, apt-get install graphviz
3, apt-get install htmlhelp
1,doxygen -g doxygen.conf 生成doxygen的配置文件
2,修改doxygen.conf
3,doxygen doxygen.conf 生成文档
4, 最后默认在目录docs下生成对应格式的文档
以下是我默认的一些选项,最好还是自己有一个模板,视情况简单改几项就OK
## Doxygen 1.6.1
## Doxyfile 1.3.8
# 以下为一些比较重要的项目
PROJECT_NAME = MY_TEST_PROJECT # 项目名
PROJECT_NUMBER = v1.0 # 版本号
OUTPUT_LANGUAGE = Chinese # 输出语言设置
EXTRACT_ALL = YES # 输出所有的函数,除去private,static
EXTRACT_PRIVATE = YES # 输出private函数
EXTRACT_STATIC = YES # 输出static函数
EXTRACT_LOCAL_METHODS = YES # 输出本地函数
HAVE_DOT = YES # 使用graphviz
CALL_GRAPH = YES # 输出调用关系
OUTPUT_DIRECTORY = ./docs/ # 输出目录
RECURSIVE = YES # 包括子目录
SOURCE_BROWSER = YES # 源代码浏览
TAB_SIZE = 4 # TAB的大小
GENERATE_LATEX = NO # 不生成LATEX格式
doxygen是个由源代码生成文档的工具,再具体的就不多说,百度或google吧
如果注释写得好的话,通过doxygen生成的文档是相当好的
现在很多开源的或非开源都通过它生成SDK的文档,真是省时省力
生成的文档可以是html的,也可以是chm、latex、pdf、xml等
文档本来就是开发与维护之间很大的一个问题,通过doxygen可以大大节省劳动力
当然,前提是要养成写好注释的好习惯
这两天,发现doxygen除了可以生成注释的文档后,还有一个相当棒的功能
感叹hacker们真是把其发挥极致
其功能就是生成函数调用图,类继承图等
这些用来分析程序结构是相当好
平时我分析程序也是一边看一边画这些类,现在终于是不用画了,跑一个命令全搞定!
现在的懒人也可以懒到极致!
另外,习惯了用linux或者windows下的cygwin,也就是习惯了unix hacker那套
windows界面那套就不多弄了,原理一样,可能只是doxygen的版本更高,配置文件
内容不同
更多参考:
http://www.fmddlmyy.cn/text21.html
http://www.codeproject.com/KB/tips/doxysetup.aspx
http://www.cnblogs.com/wangkangluo1/archive/2011/07/29/2121372.html
http://hi.baidu.com/vcba/blog/item/9dcea11ce5d3328087d6b69c.html
最后,其实大家可能都好奇,doxygen是如何得到变量名,函数名,类名,函数调
用关系,类关系等等
当然,变量名、函数名与类都是编译器的范畴,都是静态的
可是函数调用我理解为应该链接或运行时的范畴了,这还是可以值得研究一下
然后就发现了天后的天
1,分析函数调用关系图(call graph)的几种方法
http://www.cppblog.com/hacrwang/archive/2007/06/30/27295.html
2, 用Graphviz 可视化函数调用
http://www.ibm.com/developerworks/cn/linux/l-graphvis/ |