GTK督是用來記錄C代碼。它通常用於文檔庫,如GTK +和GNOME庫的公共API,但它也可以被用來記錄應用程序代碼。
需要注意的是GTK督最初沒有打算成為一個通用的文檔工具,所以它可以是一個有點尷尬的安裝和使用。對於一個更完美的通用文檔工具,你可能想看看使用Doxygen(http://www.doxygen.org/)。然而GTK督有一些特殊的代碼來記錄的GTK +部件和哪些其他工具可能不具備圖形對象類的信號和屬性。
GTK督使你的文檔被寫在2種方式:
一)嵌入特殊格式的註釋裡面的源代碼。
或
B)添加到“模板”文件,這GTK-doc的輸出掃描所有的頭文件和解析聲明之後。
從這些源代碼中的註釋和模板文件GTK-文檔生成一個XML的Docbook(或SGML)文檔,然後將其轉化成HTML。生成的HTML文檔可在一個普通的網絡瀏覽器,或通過使用專用Devhelp API瀏覽器閱覽的(見http://developer.imendio.com/wiki/Devhelp).
What是新在此版本中:
- 在GTK-DOC支持降價(標題和列表)的一個子集 - 看
- http://git.gnome.org/browse/gtk-doc/tree/tests/gobject/src/gobject.c
- 在GTK-DOC不會產生老devhelp文件了。這減少了文檔li>
- 生成時間和工程devhelp> = 0.11(於2005年發布)
- 對於超出源目錄生成變化引起的破損的項目使用
- DOC_SOURCE_DIR使用相對路徑(以builddir)。推薦使用
- DOC_SOURCE_DIR = $(top_srcdir)/ src目錄/ XXX。
- 更改
- 590927:為DOC-構建步驟支持AM_SILENT_RULES
- 617121:/ *<私人> * /枚舉中的聲明仍然顯示
- 627758:一個辦法忽略的象徵
- 639145:簡寫語法標題
- 644291:對轉讓枚舉解析器遊')
- 646870:HTML_IMAGES不再EXTRA_DIST
- 648289:gtkdoc-mkdb不編譯
- 648331:指定的'亮點'一貫兼容選項
- 649269:gtkdoc-scanobj應該設置一些自己的CFLAGS / LDFLAGS
- 650407:雖然distchecking產生數千€小野聲明founda€屋宇文檔?警告,然後失敗。
- 652746:普通盒裝結構的文檔破
- 652764:更新自動工具的配置有點
- 655711:由包總結depscan輸出
- 656453:性能改進(補丁)
- 656658:GTK-doc.make:在單獨的目錄建設安裝時目標不安裝文檔li>
- 656773:GTK-DOC無法找到聲明為“char * const的” 象徵
- 656946:GTK-DOC無法處理“的extern短整型”
- 657377:SRCDIR = builddir建立丟棄TMPL 內容
- 提供者
- Bakaoukas尼可拉斯
- 克勞德Paroz
- 丹尼爾Mustieles
- 大衛Necas
- 在大衛NEA ??為
- 哈維爾JardA³n
- 豪爾赫·岡薩雷斯
- 馬里奧BlA¤ttermann
- 馬蒂亞斯Clasen
- MichaA,GA³rny
- 肖恩麥坎斯
- 斯特凡·紹爾(考斯特)
- 威爾·湯普森
- 亞科夫Selkowitz
要求:
- 在Perl的V5
- &的libxslt libxml2的2.3.6
- 在DocBook XSL樣式表
- 的DocBook XML DTD
- 在DocBook的SGML DTD
- 玉V1.1或OpenJade 1.3.1
- 在DocBook的DSSSL樣式表
評論沒有發現