doxygen是幫助改進工程結構和相關優化的工具,能夠提供工程類調用關系圖和函數調用關系圖。
主要需要下面這些操作:
1) doxygen, 2)Graphviz,圖形化可視軟件,3)iconv,中文編碼轉化工具。
將這些安裝好以后,打開doxygen主界面選擇expert.進行相關配置,其中要配置的信息包括:1)project,主要是工程名稱和版本以及輸出目錄,這里關系到chm文檔第一頁顯示的標題。2)Build,主要是選擇顯示的模式,比如Extract_ALL:將顯示程序所有的元素:類,函數,變量;Extract_PRIVATE:顯示私有變量等。3)Message,warn_logfile項目里面可以給出出錯以及相關的編譯log,之后的編譯信息都將在這個對應的log文件里面找到。4)Input,主要是輸出你要生成軟件文檔的工程,這里要給出目錄。5)source browser,代碼瀏覽器,是否可以瀏覽到代碼。6)HTML,如果要產生CHM文檔的話,那么就一定得要選擇generate_htmlhelp,7)dot, 這里主要是要選擇CLASS_DIAGRAMS,UML_LOOK,CALL_GRAPH,CALLER_GRAPH.等顯示類結構圖,uml圖,被調用者關系圖,調用者關系圖。
之后做一些選擇就可以生成doxyfile的東西,按照這個doxyfile的東西就可以生成相應的配置信息,doxyfile是doxygen的配置信息,是可以被編輯的。
配置好之后,就可以生成相關的html文件,png文件等。
之后再用chm打包成chm文件,方便查閱。
這里可以借助其它的打包軟件來處理這些,因為html打包的容量有限,并且doxygen生成的html有時候也有問題,比如關聯的東西太多了,就會產生很多麻煩,比如html無法正常產生,我有次就產生以后,發現其中的html字節都為0KB,很郁悶,chm來打包也是很有問題的,打包東西太多了,就sb了,所以做到這點可以用doxygen+打包軟件(未必是chm文件).
一些其他有用信息可以在這里獲得:
http://www.fmddlmyy.cn/text21.html