GTK-DocC語(yǔ)言文檔生成工具

GTK-Doc 是一個(gè)用來(lái)從C代碼的注釋中生成API文檔的工具，尤其適用于使用gobject對(duì)象機(jī)制編程的項(xiàng)目，并不局限于GTK+或GNOME相關(guān)library和程序的文檔生成。

主要工作流程

基本上，使用GTK-Doc生成API文檔，包括幾個(gè)步驟：

• 在項(xiàng)目相關(guān)目錄和Build相關(guān)文件中添加 GTK-Doc所需參數(shù)和相關(guān)配置文件。
• 在代碼中按照一定的格式規(guī)范添加注釋（于普通的注釋相比，只需要添加非常少的額外信息）
• 使用標(biāo)準(zhǔn)的Build流程（autogen，configure，make等）編譯并生成文檔
• 修改部分GTK-Doc生成的模板和配置文件，進(jìn)行一些定制工作，如排除某些函數(shù)，定制布局，添加而外的help文檔等（這部分工作并不需要每次都做，這些模板和配置文件只在第一次build的時(shí)候生成，以后不會(huì)自動(dòng)覆蓋）