编辑“BugFree/理解BugFree代码”

{{BugFree top}}

*看懂别人的代码并不是一件容易的事情。如果没有好的[[IDE]] 开发工具可利用就更是难上加难了。

*Doxygen 和Graphviz 这俩开源软件可以帮助我们把读懂别人代码这件事情变得容易许多。这俩开源软件真可谓珠联璧合，用它俩为[[BugFree]] 的代码自动生成了[[代码]]文档，函数调用关系一清二楚。也看得出BugFree 的主要开发者的大部分注释写得还比较正规的。

*下图是“bugCreateMailMessage”这个函数的详细信息，包括“Author”、“Parameters”、“Returns”,更为重要的是用图形方式列出来该函数调用(Reference)了哪些函数，以及被哪些函数调用（Referenced by）。

[[文件:bugfreeDM1.png]]

[[文件:bugfreeDM2.png]]

*Doxygen 的[[GUI]] 很简洁，可以点击“Wizard”按钮进行一些简单设置，

[[文件:bugfreeDM3.png]]

也可以点击“Expert”进行详细地设置：

[[文件:bugfreeDM4.png]]

*如果您对Doxygen 已经掌握地炉火纯青，还可以直接编撰类似下表的配置文件：(注意：以下三项都设置为“YES”后，才能把函数调用关系图给生成出来。
<pre>
HAVE_DOT = YES
CALL_GRAPH = YES
</pre>

*选择最终生成[[chm]] 格式的代码文档，下图是BugFree1.1 版本的代码文档抓图：

[[文件:bugfreeDM5.png]]

==参考来源==
*http://www.elecfans.com/soft/68/guide/2011/20110418195321.html

[[category:BugFree|B]]

{{BugFree}}