2013-03-07 53 views
2

根據docs,您始終使用指向一組HTML文件的doxygen標記文件。那麼標記文件本身做什麼?對於生成700個HTML文件的中等大小的項目,我的標記文件是500Kb,因此顯然有很多內容。但是什麼 - 爲什麼我不告訴doxygen外部文檔的位置?doxygen標記文件究竟是什麼?

回答

2

標記文件就像C的預編譯頭文件一樣。它包含外部項目中的所有符號以及每個符號的相應HTML文檔的深層鏈接。它只是一個XML文件,所以你可以打開它,看看裏面有什麼。

您不能僅僅告訴doxygen外部文檔的位置,因爲它沒有任何信息可以深入鏈接到每個符號。它所能做的只是指向文檔樹的根,但這不是非常用戶友好的。

理論上,doxygen可以嘗試直接從生成的HTML文件中提取鏈接(事實上這在過去是可行的),但這非常脆弱,並且經常打破,因此刪除了該功能。

+0

有趣的功能,是否有任何工具可以將javadoc'package-list'文件轉換爲標籤文件?那將是真棒。 – rekire 2013-11-08 06:48:13