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文件了。这减少了文档
- 生成时间和工程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:在单独的目录建设安装时目标不安装文档
- 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样式表
评论没有发现