GTK-Doc

GTK-Doc C kodu sənədləşdirilməsi üçün istifadə olunur. Bu adətən belə GTK + və GNOME kitabxanaları kimi kitabxana, ictimai API sənədləşdirilməsi üçün istifadə olunur, həm də proqram kodu sənədləşdirilməsi üçün istifadə edilə bilər.
GTK-Doc ilk ümumi təyinatlı sənədlər alət üçün nəzərdə deyil Qeyd edək ki, belə ki, quraşdırma və istifadə etmək yöndəmsiz bir az ola bilər. Daha cilalanmış ümumi təyinatlı sənədlər alət üçün Doxygen (http://www.doxygen.org/) baxmaq istəyirəm bilər. Lakin GTK-Doc GTK + widgets və digər alətlər ola bilər GObject dərsləri siqnalları və xassələri sənəd xüsusi kodu var.
GTK-Doc sənədlər 2 yollarla yazılı imkan verir:
a) xüsusi biçimlendirilmiş şərh mənbə kodu daxili Ankastre.
və ya
b) bütün mövzu faylları scanning və bəyannamələrin təhlil sonra şablon faylları gtk-doc nəticələr əlavə.
Bu mənbə kodu şərh və şablon faylları GTK-Doc sonra HTML çevrilir bir DocBook XML (və ya SGML) sənəd yaradır From. yaradılan HTML sənədlər adi web browser və ya xüsusi Devhelp API browser istifadə edərək, göz olar (http://developer.imendio.com/wiki/Devhelp).

What yeni görmək Bu azad

• gtk-doc markdown (başlıq və siyahıları) bir alt dəstəkləyir - görmək
• http://git.gnome.org/browse/gtk-doc/tree/tests/gobject/src/gobject.c
• gtk-doc köhnə devhelp bir daha faylları yaratmaq deyil. Bu doc ​​aşağı azalıb
• nəsil vaxt və devhelp və GT üçün çalışır. = 0.11 (2005-ci ildə azad edilib)
• out-of-mənbə dir qurmaq üçün dəyişikliklər istifadə layihələri üçün qırılmaları səbəb
• (builddir üçün) bir nisbi yolu ilə DOC_SOURCE_DIR. Bu istifadə etmək tövsiyə olunur
• DOC_SOURCE_DIR = $ (top_srcdir) / src / xxx.
• Bu dəyişiklikləri
• 590927: doc qurmaq addımlar üçün Support AM_SILENT_RULES
• 617121: / * & lt; Şəxsi & gt; * / Enums da bəyannamə hələ göstərilir
• 627758: bir simvolu ignore üçün bir yol
• 639145: başlıqları üçün stenoqrafiya syntax
• 644291: təyin edilməsi haqqında Enum parser fasilələri) '
• 646870: artıq EXTRA_DIST da HTML_IMAGES
• 648289. Gtkdoc-mkdb tərtib etmir
• 648331. Ardıcıl "məqamı üçün uyğun variantları daxil
• 649269: gtkdoc-scanobj öz CFLAGS bəzi müəyyən etməlidir / LDFLAGS
• 650407: distchecking bir € Ono bəyannamə Founda € minlərlə istehsal isə Buildings docs ?? xəbərdarlıq, sonra uğursuz.
• 652746: broken düz kutulu structs Documentation
• 652764: bir az config Update Autotools
• 655711: paketi depscan çıxış yekunlaşdırmaq
• 656453: Performans təkmilləşdirilməsi (PATCH)
• 656658: gtk-doc.make: ayrı-ayrı kataloq tikinti zaman docs yüklemek deyil hədəf yüklemek
• 656773: gtk-doc "char * Const"
elan simvolu tapmaq üçün uğursuz
• 656946: "extern qısa int idarə etmək üçün gtk-doc bilmir
• 657377: srcdir = builddir TMPL
məzmunu imtina qurur
• Yazarlar
• Bakaoukas Nikolaos
• Claude Paroz
• Daniel Mustieles
• David Nəcaşi
• David Nea ?? kimi
• Javier JardA³n
• Jorge Gonzalez
• Mario BlA¤ttermann
• Matthias Clasen
• MichaA, GA³rny
• Shaun McCance
• Stefan Sauer (Kost)
• Will Thompson
• Yaakov Selkowitz

tələblər

• Perl v5
• libxslt & Libxml2 2.3.6
• DocBook XSL stil
• DocBook XML DTD
• DocBook SGML DTD
• Jade v1.1 və ya OpenJade 1.3.1
• DocBook DSSSL stil