1 GTK-Doc 1.28.1 (Mar 24 2018)
6 GTK-Doc 1.28 (Mar 24 2018)
13 o 791928 : gtk-doc doesn't understand 'stability: Obsolete'
14 o 792148 : cmake: Installed GtkDocConfig.cmake has incorrect bindir path
15 o 792661 : use pygments to do syntax highlighing
16 o 793599 : Please run testsuite with V=0
17 o 794051 : rebase: fix on-line location extraction from devhelp files
18 o 794182 : private_header regex is broken
34 GTK-Doc 1.27 (Dec 07 2017)
37 Finetune the python port.
41 o 773879 : scangobj: Do not generate unused parameters
42 o 786174 : Several test failures on Arch Linux
43 o 787495 : gtkdoc-fixxref crashes when running vim for syntax highlighting
44 o 787768 : Aborts when glib2.0-dev is not installed
45 o 787862 : Always open files in text mode and always use utf-8
46 o 788473 : fixxref crashes if a .devhelp2.gz file is found
47 o 789531 : Don't depend on the system shell
48 o 790022 : mkdb: Add support for (not optional) annotation
49 o 791131 : gtk-doc and python3: fixxref failures
59 Jan Alexander Steffens (heftig)
69 GTK-Doc 1.26 (Aug 11 2017)
72 Remove tmpl support (gtkdoc-mktmpl). Port all tools from bash/perl to python.
76 o 773879 : scangobj: Do not generate unused parameters
77 o 780789 : Convert gtkdoc-scan from Perl to Python
78 o 752126 : Add support for inline program documentation
79 o 753052 : _() causes element a: validity error : ID idx already defined
80 o 758137 : GtkLabel and GtkShortcutsShortcut notes on escaping character entities don't render properly
81 o 764407 : Broken links to structs in function definitions
82 o 764543 : /usr/bin/gtkdoc-mkpdf always exits with an error
83 o 768675 : make check fails on master
84 o 769125 : gtkdoc-mkhtml/pdf fails on spaces in search path
85 o 769341 : gtkdoc-mkdb line 3966 triggers "Negative repeat count does nothing" warnings
86 o 771255 : "Symbol name not found at the start of comment block" warning with "attributes" annotation.
87 o 773151 : configure: Lower perl dependency to 5.16.0
88 o 774168 : gobject introspection annotations and gtk-doc parser do not agree
89 o 774812 : Error messages from xsltproc are hidden by gtkdoc-mkhtml
90 o 778144 : Allow disabling introspection for ancillary property mechanisms
91 o 779566 : Replace shell executables with Python
119 Víctor Manuel Jáquez Leal
121 GTK-Doc 1.25 (Mar 21 2016)
126 o 763465 : – released version of gtk-doc no longer understands cross-reference data in gtk+
127 o 742404 : unify index.sgml and *.devhelp2 + change gtkdoc-fixxref to use *.devhelp2
128 o 743182 : Automatically support PACKAGE variables as XML entities
129 o 744061 : Skip standard g_iface, parent_instance and parent_class struct members
130 o 751479 : help: Document the Stability tag for documentation comments
131 o 751777 : gtk-doc -sections.txt file documentation is a bit confusing
132 o 751783 : Creating master xml document documentation is a bit lacking
133 o 751906 : help: Fix incorrect example syntax for embedded images
134 o 752795 : documentation is not rebuilt when only content of doc comments change
135 o 753145 : gtkdoc-mkhtml fails on spaces in file names
136 o 753348 : gtkdocize does not handle -flat flavours
137 o 756297 : Add CMake module
138 o 756368 : gtkdocize mistakenly parses options from comments in configure.ac
139 o 756519 : `make check' fails - Sequence (?R...) not recognized in regex
140 o 756684 : Support (not nullable) annotation
141 o 756998 : Support |[ < !-- language= " plain " -- > ]|
142 o 758996 : gtkdoc-mkdb: ensure macros appear in the correct section
143 o 759017 : autogenerated ids in return and parameter blocks
162 GTK-Doc 1.24 (May 29 2015)
165 This is another quick bugfix release for a regression, see bug #749591
169 o 749591 : gtk-doc 1.23 no longer includes xml namespace in .devhelp2 files
170 o 749706 : .gitignore files should not be under version control
171 o 749816 : Support syntax highlighting of different languages (patch included)
172 o 749901 : Strip common indent when highlighting with vim
182 GTK-Doc 1.23 (May 17 2015)
185 This is a quick bugfix release for a regression, see bug #749142.
189 o 749142 : Can't build totem-pl-parser from master using gtk-doc 1.22
190 o 749210 : mkman: Use full URL to refer to the docbook manpages stylesheet
197 GTK-Doc 1.22 (May 07 2015)
200 Important notice - starting with the next release these long deprecated
201 features will be removed - you'll now see a warning if you actually use these
202 features. Please write to gtk-doc-list@gnome.org and tell us your concerns:
203 o gtkdoc-mktmpl - please move all the comments into the sources.
204 o generating html via sgml tools (jade/openjade), using xsltproc and
205 docbook-xslt is pretty common and preferred since version 1.6
209 o 727778 : – gtk-doc doesn't understand annotations for GList-contained types
210 o 729911 : Using #TypeName inshort_description makes " - " in HTML index disappear
211 o 732689 : strange result on a generated html page
212 o 734689 : " Specific - > General " document title format
213 o 736073 : Regression: problems with enum constants
214 o 736725 : Documentation consists mostly of empty space
215 o 741305 : Scanner issue with enum containing value ='{'
216 o 741763 : Example Makefile.am improvements
217 o 741941 : Last function argument missing in docs (possibly due to macro in code)
218 o 743879 : special case G_DECLARE_*_TYPE
219 o 743967 : Make build results reproducible
220 o 744075 : Missing struct members if forward declared in another header
221 o 744368 : gtkdoc-depscan doesn't handle unicode in .devhelp2 files correctly
222 o 746118 : gtkdoc-scan: fix regex for get_type() functions
223 o 746120 : Expand annotation recognition on symbol lines
224 o 746121 : gtkdoc-mkdb: don't warn on 'deprecated entities'
225 o 747207 : Typos in documentation
226 o 747298 : Test still tries to check gtkdoc-scanobj
227 o 748456 : xsl: Enable ToC generation on empty < toc/ > elements
235 Dominique Leuenberger
249 GTK-Doc 1.21 (Jul 17 2014)
252 Important notice - starting with the next release these long deprecated
253 features will be removed, please write to gtk-doc-list@gnome.org and tell us
255 o gtkdoc-mktmpl - please move all the comments into the sources.
256 o generating html via sgml tools (jade/openjade), using xsltproc and
257 docbook-xslt is pretty common and preferred since version 1.6
261 o 170860 : gtk-doc should have definitions for stability
262 o 644111 : one cannot specify against which libs gtkdoc-fixxref should resolve links (problematic with multiple versions)
263 o 657444 : " enum foo { ... } " ; not recognized
264 o 671519 : Self-test relies on nonportable (GNU enhanced) 'date' command
265 o 678094 : the word " returns " in a function description can be parsed as the " Returns: " section
266 o 722621 : gtk-doc tarball was created with 32bit uid/gid, unusable with mingw/msys tar
267 o 724739 : Self-test fail: gtkdoc-mkdb misusing perl datatype
268 o 725505 : new syntax highlighting for code is weird
269 o 725663 : configure: non POSIX test usage
270 o 730658 : Deprecation warning for non-deprecated type GParamFlags
271 o 730777 : Add support for nullable and optional annotations
288 GTK-Doc 1.20 (Feb 16 2014)
291 Important notice - starting with the next release these long deprecated
292 features will be removed, please write to gtk-doc-list@gnome.org and tell us
294 o gtkdoc-scanobj (only used for gtkobject)
295 o return values need to be documented using "Returns:". We will remove the
296 heuristic that turns a paragraph starting with "Returns " into return docs.
297 o gtkdoc-mktmpl - please move all the comments into the sources.
298 o generating html via sgml tools (jade/openjade), using xsltproc and
299 docbook-xslt is pretty common and preferred since version 1.6
303 o 605537 : Returns: listed among parameters
304 o 624001 : Support attribute-based method to deprecate symbols
305 o 662424 : Class hierarchy about interfaces not generated by default
306 o 665926 : should not have to document object structures
307 o 666509 : Specifying --enable-gtk-doc should not be required to build source packages
308 o 669417 : Duplicate IDs generated for unions registered as boxed types
309 o 671519 : Self-test relies on nonportable (GNU enhanced) 'date' command
310 o 692367 : gtkdocize should take a srcdir argument
311 o 696570 : style updates
312 o 697940 : Race condition between setup-build.stamp and scan-build.stamp
313 o 701259 : /bin/bash: -chmod: command not found
314 o 701638 : Support automake parallel test harness (fix error with GTKDOC_CHECK)
315 o 706404 : Minor bug in gtkdoc-mkdb
316 o 706438 : Empty lines added at the beginning and at the end of a programlisting
317 o 707426 : master is broken in picking up flavour from configure.ac
318 o 707717 : Support " Deprecated: X.Y "
319 o 708268 : New *-insensitive.png files are not distributes
320 o 710478 : gtkdoc-mkdb: Don't complain about annotations with hyphen
321 o 711111 : gtkdoc-mkdb: sort entries in the glossary
322 o 711598 : gtkdoc-scan doesn't ignore decorators containing parentheses
323 o 719644 : docs: make yelp usage conditional in manual
324 o 719645 : configure: emit message when looking for yelp
325 o 720061 : make: create subdirectories of the content_files to the builddir
326 o 721228 : configure: search for xml catalog in XDG_DATA_DIRS
327 o 722479 : cp -u is not portable
328 o 723118 : Mark |[ blocks as CDATA
329 o 723288 : Fix MarkDown support
330 o 723417 : New MarkDown parser
331 o 723696 : Add support for blockquote
332 o 723812 : Add support for reference links
333 o 723913 : List in markdown: < p > inside the last element of a < ul > list
334 o 723991 : Improve the display of the synopsis
335 o 724002 : gtkdoc-scan: Fix use of uninitialised value in trace logging
360 Zbigniew Jędrzejewski-Szmek
362 GTK-Doc 1.19 (Jun 05 2013)
367 o 652740 : Warnings during expansion of content files
368 o 660436 : Warning for skip annotations on function parameters
369 o 661853 : allow EXTRA_DIST to be predefined
370 o 668228 : several of the tests use syntax not compatible with traditional Bourne shells
371 o 670724 : gtk-doc.make: double recursion when maintainer-clean
372 o 670767 : generated file gnome-doc-utils.m4 is in version control
373 o 670796 : (patch) Show commands when building documentation with make
374 o 671519 : Self-test relies on nonportable (GNU enhanced) 'date' command
375 o 671960 : make dist fails without html/*
376 o 672710 : Use new documentation infrastructure
377 o 676685 : Allow to order functions without using $MODULE-sections.txt
378 o 685365 : (PATCH) Fix contents of warning message, should be " -sections.txt " not " -section.txt "
379 o 686148 : [patch] suggested parameters for gtkdoc-scangobj
380 o 687685 : 'g_type_init' is deprecated
381 o 688204 : undocumented enum values missing in indexes
382 o 688423 : Add support for " transfer floating " introspection annotation
383 o 689209 : Automake complains about trailing space after backslash.
384 o 690438 : Small improvements
385 o 696930 : Incorrect allowed value for a property
386 o 700981 : make: copy the files with their relative path included
424 GTK-Doc 1.18 (Sep 14 2011)
427 o gtk-doc supports a subset of markdown (headings and lists) - see
428 http://git.gnome.org/browse/gtk-doc/tree/tests/gobject/src/gobject.c
429 o gtk-doc does not generate old devhelp files any more. This cuts down doc
430 generation time and works for devhelp >=0.11 (was released in 2005).
431 o changes for out-of-source dir build caused breakage for projects using
432 DOC_SOURCE_DIR with a relative path (to builddir). It is recommended to use
433 DOC_SOURCE_DIR=$(top_srcdir)/src/xxx.
437 o 590927 : Support AM_SILENT_RULES for doc-build steps
438 o 617121 : /* < private > */ declarations in enums are still displayed
439 o 627758 : A way to ignore a symbol
440 o 639145 : shorthand syntax for headings
441 o 644291 : Enum parser breaks on assignment of ')'
442 o 646870 : HTML_IMAGES no longer in EXTRA_DIST
443 o 648289 : gtkdoc-mkdb doesn't compile.
444 o 648331 : Specify compatible options for 'highlight' consistently.
445 o 649269 : gtkdoc-scanobj should set some of its own CFLAGS/LDFLAGS
446 o 650407 : Buildings docs while distchecking produces thousands of “No declaration found” warnings, then fails.
447 o 652746 : Documentation of plain boxed structs broken
448 o 652764 : Update autotools config a bit
449 o 655711 : summarize depscan output by package
450 o 656453 : Performance improvements (PATCH)
451 o 656658 : gtk-doc.make: install target doesn't install docs when building in a separate directory
452 o 656773 : gtk-doc fails to find a symbol declared as 'char* const'
453 o 656946 : gtk-doc unable to handle 'extern short int'
454 o 657377 : srcdir!=builddir builds discard contents of tmpl
474 GTK-Doc 1.17 (Feb 16 2011)
479 o 127049 : building reference documentation fails when builddir != srcdir
480 o 640241 : non-srcdir builds busted
488 GTK-Doc 1.16 (Jan 14 2011)
491 o gtkdoc-check can do more checks, one might need to update Makefile.am from
492 the examples/Makefile.am
496 o 625776 : serialise doubles and floats always with a decimal dot
497 o 627269 : link to signalflags docs from signal descriptions
498 o 467488 : GTK+ man pages request
499 o 481811 : Inline function bodies are confused with declarations
500 o 501107 : EXTRA_DIST automake warnings
501 o 512565 : add GTK_DOC_IGNORE
502 o 518427 : documentation best pratices needed
503 o 597937 : Function pointers as parameters to other functions are parsed improperly
504 o 612028 : gtkdoc-fixxref should call /usr/bin/vim -n -e -u NONE -T xterm
505 o 617478 : Tooltip is a nuisance
506 o 618379 : Navigation is hiding anchors title
507 o 620249 : invalid xml for object_index with (n_objects % 3) == 0
508 o 621931 : support GType and GVariant types
509 o 622971 : List of typos in the GTK-doc manual
510 o 623777 : G_TYPE_STRV in signals generate wrong docs
511 o 623968 : gtkdoc-mkdb generates invalid xml from sgml in inline comments
512 o 624199 : parser picks up contents of large macros
513 o 624200 : 'const' confuses the parser
514 o 627223 : gtkdoc-fixxref vim highlight fails on xhtml suffix
515 o 627920 : `make check` rule to list xml files missing from DOC_MAIN_SGML_FILE
516 o 628611 : gtk-doc > = 1.13 creates automagic dependencies on syntax highlighters
517 o 628794 : Issue in gtkdoc-mkman.in
518 o 630288 : Fix 'scope notified' annotation
519 o 631336 : remove lists of gtk+ signal args in gtkdoc-scanobj and -scangobj
520 o 632587 : gtkdoc-scanner fails to identify (closure) annotation
521 o 638330 : const in parameter list is ignored
522 o 638831 : Support GTK+ 3 cell properties
529 Gilles Dartiguelongue
545 GTK-Doc 1.15 (May 21 2010)
550 o 614496 : Support for multiple DOC_SOURCE_DIR directories
551 o 615550 : gtk-doc fails to recognize (scope ...) and (skip) annotations
561 GTK-Doc 1.14 (Mar 28 2010)
566 o 593282 : Append " _struct " prefix to every struct name
567 o 599514 : sane support for per-page images
568 o 604892 : checks fail
569 o 613611 : parameter descriptions with annotations truncated at first \n
570 o 115531 : add short description to index entries
571 o 165425 : gtk-doc fails to parse unions
572 o 512155 : gets confused by multiline typedef
573 o 568711 : undocumented enum values are not reported
574 o 590602 : secondly running gtkdoc-mkdb will generate DOCTYPE missing XML files
575 o 590625 : $(DOC_MODULE)-overrides.txt is required by " make dist "
576 o 591975 : Section_Id always embeds a trailing newline
577 o 604885 : Fix the use of gtkdocize --flavour option
578 o 604992 : gtkdoc-fixxref broken link warning is broken for functions
579 o 604995 : Syntax error in gtkdoc-mkman
580 o 604998 : Check for syntax errors in the test suite
581 o 605052 : put class structs to the generated section file
582 o 605211 : Many build failures with gtk-doc 1.13
583 o 605281 : Add " Since " and " Deprecated " tag to function example
584 o 605285 : Add < keycap > and < keycombo > example
585 o 605289 : Some documentation improvements
586 o 605452 : Added more info to " Documenting symbols " sectio
587 o 605564 : Env var equivalent to --flavour=no-tmpl
588 o 606661 : XInclude error while gnerating documentation
589 o 607445 : gtk-doc does not support long double as returned value type
590 o 607531 : Execute system() calls in subshells to ease debugging
591 o 609062 : [All-langs] [gtk-doc] Translated *.po files not available within ~/po directory
592 o 609194 : sort interface implementers
593 o 610255 : Self-test failure in git as of 2010-02-17: FAIL: gobject.sh
594 o 610257 : Patch to make GTK-DOC notice functions/variables with 'signed' prototypes
595 o 611848 : gtk-doc produces invalid DocBook markup if the SECTION ends with a tag that cannot be nested inside < para >
601 Emilio Pozuelo Monfort
602 Francisco Javier F. Serrador
620 GTK-Doc 1.13 (Dec 18 2009)
623 o 604891 : gtk-doc tarball does not build
629 GTK-Doc 1.12 (Dec 18 2009)
634 o 591450 : Build related fixes
635 o 466535 : generate documentation as pdf
636 o 502191 : acronym support
637 o 532395 : inline function parsing problems (e.g. in glib api docs)
638 o 536928 : have syntax highlghted and xrefs source code samples
639 o 562064 : index generation trouble
640 o 562310 : glib 2.18.3: /bin/sh: line 1: gtkdoc-rebase: command not found
641 o 562655 : doesn't produce deprecation note for signals
642 o 565126 : linking to struct members
643 o 565835 : Three spelling errors in gtk-doc-manual
644 o 566911 : add support for --help and --version to remaining tools
645 o 567132 : Take FOO_GET_INTERFACE as standard
646 o 568702 : gtkdoc-mkhtml no longer works when symlinked
647 o 568706 : gtkdoc-scan: use CamelCase id for interfaces
648 o 568708 : gtkdoc-scan should try not to scan files twice
649 o 568714 : Perl errors when syntax highlighting is not available
650 o 568732 : missing long descriptions undetected
651 o 568734 : configure check for gtk-doc prints that gtk-doc cannot be built
652 o 569339 : abbreviation are not expanded at the start of text
653 o 572396 : Fix to use shave + gtk-doc + libtool 1.x
654 o 572612 : Mistakenly substitute -1 with G_MAXULONG in x86_64
655 o 572967 : use g_strerror
656 o 574654 : --ignore-decorators does not ignore trailing stuff
657 o 575574 : Be more friendly for files with a space in their name
658 o 575623 : Update FSF address
659 o 575711 : < table > element mismatch in highlighted code
660 o 576313 : implicit declarations in testsuite ?
661 o 577059 : Gnome-doc support can't be disabled
662 o 577774 : Test suite run even when built with --disable-gtk-doc
663 o 580206 : gcc warnings in < module > -scan.c
664 o 580300 : gtkdoc-scan picks up _get_type functions it should not
665 o 580622 : xml dir is both part of distclean and dist rules
666 o 581237 : gtk-doc uses wrong gtkdoc-check in " make check " phase
667 o 584952 : " uninitialized value in concatenation " gtkdoc-mkdb line 938
668 o 587103 : return values of function-like macros
669 o 587196 : Typo in a string
670 o 589426 : Python is a required dependency
671 o 591789 : master FTBFS with automake 1.11
672 o 594224 : Please fix manual about inlined SECTION comments (and show warnings when invalid)
673 o 596730 : Signed vs. unsigned comparison in gtkdoc-scangobj.in causing compile errors
674 o 596731 : autogen.sh doesn't recognize automake-1.11
675 o 602026 : Warn if non-existing function gets referenced
676 o 602518 : Doesn't support " long int " return type
677 o 604798 : tests/fail.sh and tests/tools.sh.in use bashisms
699 GTK-Doc 1.11 (Nov 16 2008)
704 o 531572 : one-page generation option
705 o 448879 : Use a footer when generating HTML documentation
706 o 311857 : xsltproc very slow generating index for gtk-docs.sgml
707 o 335239 : Using gnome-doc-utils for gtk-doc documentation
708 o 460753 : enable vpath build in gtkdoc-mkhtml
709 o 473342 : Warn about repeated symbols in sections
710 o 487727 : DocBook XML DTD version
711 o 523669 : make check: Element publisher content does not follow the...
712 o 530758 : gtk-doc should not expand XML tags and their attributes
713 o 533262 : no-template mode scans different source files
714 o 534627 : gtk-doc uses non-standard HTML element
715 o 542137 : No declaration found for: gsf_output_*
716 o 543855 : Fix for Bug 460753 (enable vpath build in gtkdoc-mkhtml) ...
717 o 544172 : Fails to parse return value of 'char const *'
718 o 552822 : Add rules to create $(REPORT_FILES)
719 o 553407 : Example Makefile.am uses obsolete INCLUDES instead of AM_...
720 o 554718 : gtk-doc needs to allow versioned TARGET_DIR
721 o 554833 : Be more careful with " struct _ < struct_name > "
722 o 558082 : evince docs build fails with GTK_DISABLE_SINGLE_INCLUDES
723 o 559281 : Correct check for existance of gtkdoc-rebase
740 GTK-Doc 1.10 (Mar 20 2008)
745 o 460753 : enable vpath build in gtkdoc-mkhtml
746 o 503119 : Add dependency on content_files to SGML target
747 o 127049 : building reference documentation fails when builddir != s...
748 o 481811 : Inline function bodies are confused with declarations
749 o 448879 : Use a footer when generating HTML documentation
750 o 492005 : Deprecation guard warnings for properties and signals
751 o 498521 : Inconsistent compiler flags passed in gtk-doc.make
752 o 365913 : gtk-doc output is not predictable
753 o 446648 : gtk-doc does not handle forward typedef'd enums
754 o 468278 : Display proper types for properties
755 o 497367 : don't use US-ASCII for output encoding
756 o 501066 : Missing quotes around gtkdoc-rebase check cause a warning
757 o 508897 : [PATCH] Fix build when gtk-doc is not installed
758 o 509539 : Building documentation aborts when no .types file is present
759 o 512154 : Struct member type attributes are limited to one token
760 o 513318 : gtk-doc.el doesn't work fine with emacs22
780 GTK-Doc 1.9 (Sep 30 2007)
785 o 419308 : unsynced regexps for parameter parsing
786 o 449618 : Top navigation bar is in the way
787 o 453717 : fixxref logic to determine absolute path's is flawed
788 o 457173 : unit tests for gtk-doc
789 o 465920 : Use gtkdoc-rebase
790 o 467773 : default master doc should have proper extension
791 o 141869 : Poor error generated when faced with a type declared as '...
792 o 156643 : Avoid make error in gtk-doc.make
793 o 322035 : wrong macro parsing
794 o 323938 : gtk-doc.m4 check is silent
795 o 324535 : gtk-doc doesn't handle deprecation inside enumerations
796 o 355352 : If you don't have an instantiatable type for a gtypeinter...
797 o 379466 : Improve C parser to handle TYPE\nVARIABLE in function pro...
798 o 380824 : docs are truncated if line begins with '* returns '
799 o 383456 : ' make check ' test for 100% documentation
800 o 411739 : Gtk-doc fails to handle ' struct tm * function_name (); '
801 o 415388 : Please clean -undocumented.txt files
802 o 418027 : gtkdoc-mkdb does not handle #ifdef in enum {}
803 o 419997 : parameter name trouble
804 o 428596 : Warnings with gtk-doc.m4 macros
805 o 434134 : fixxrefs like sed for installing pregenerated docs
806 o 436565 : Report undeclared symbols into a file
807 o 445596 : Impossible to link a page with an anchor
808 o 445693 : Does not understand ' unsigned long ' as a type
809 o 450338 : Make gtk-doc.m4 fail when needed gtk-doc is not installed
810 o 454916 : gtk-doc should permit generation of URI-based cross-refer...
811 o 457077 : add --no-implicit-returns to gtkdoc-mkdb
812 o 459225 : Accept automake-1.10 in autogen.sh
813 o 459725 : ' jhbuild build gtk-doc ' fails on make
814 o 460127 : parsing nested union/structs confuses public/private state
815 o 465365 : [PATCH] gtk-doc does not compile
816 o 466559 : [CSS] styling <hr />;
817 o 471014 : G_CONST_RETURN * G_CONST_RETURN * function not picked up
818 o 477532 : function variables
819 o 479913 : gtk-doc.notmpl.make is not distributed
820 o 479923 : distclean test output properly
836 GTK-Doc 1.8 (Feb 16 2007)
839 o Made it easier to include example code in the source code comment blocks.
840 "|[ ... ]|" can be used to delineate example code (it just gets converted
841 to "<informalexample><programlisting>"), and most of the text in example
842 code is left as it is. The only thing that is still expanded is
843 '#' to allow links to a symbol's documentation, e.g. '#GtkWidget'.
844 o Made the field widths wider for the HTML output, so it looks a bit nicer.
845 o Added a '--rebuild-sections' option to gtkdoc-scan to automatically rebuild
846 the MODULE-sections.txt file. This only works if all the header files are
847 organized neatly and functions don't need rearranging in the docs.
848 o Added a '--rebuild-types' option to gtkdoc-scan to automatically rebuild
849 the MODULE.types file, so you don't need to add new types manually.
850 o Leave CDATA sections as they are, in the extra XML content files and within
851 source code comment blocks.
852 o Allow the section id and #include's to be set within the "SECTION:" comment
853 block, using "@Section_ID:xxx" and "@Include:".
854 o Added "--default-includes" option to specify the default #include's (for
855 people who are using --rebuild-sections and so can't specify it in
856 MODULE-sections.txt).
857 o Added a '--query-child-properties' argument to help document child
858 properties of arbitrary GObjects (used by things like canvas widgets).
859 o Fixed documentation of signals of interfaces.
862 GTK-Doc 1.7 (Jul 29 2006)
865 o Fixed bug that resulted in empty "@:" lines in the templates.
866 o Fixed a few bugs with the XSL code.
867 o Supported a few more variations of C syntax.
868 o Remove the internally-used '-struct' suffix from links to widget structs.
869 o Fixed a few missing build dependencies.
870 o Added a new "C-x4s" binding to the emacs lisp code, to insert a blank
871 section header in the source code.
872 o Fixed bug that ignored inline section header docs with '-' in their names.
873 o Added a 'make docs' target that can be used to build the docs even when
874 gtk-doc has been disabled at configure time.
877 GTK-Doc 1.6 (Apr 9 2006)
880 o Removed the hard dependancy on openjade or jade, since XML is used mainly
881 now rather than SGML.
882 o Install the .pc file in $(datadir) rather than $(libdir) since gtk-doc is
883 architecture-independant.
884 o Added "--ignore-decorators" option to ignore a list of declarators in
885 function declarations.
886 o Support '#Object::signal'/'#Object:property' to link to signals/properties
887 o Fixed missing index terms.
890 GTK-Doc 1.5 (Mar 7 2006)
893 o Output the new version of devhelp2 information, but still generate the old
894 devhelp files so older versions of DevHelp still work OK.
895 o Fixed the initial creation of the *-sections.txt file so the object
896 hierarchy, signals and properties all work automatically.
897 o Show information about signal flags (run first/last).
898 o Support a --source-suffixes argument specifying which source files to scan.
899 o Support other root object types besides GObject and GInterface.
900 o Use a fixed navigation bar for the generated documentation.
901 o New documentation from Stefan Kost.
902 o Handle more variations of C syntax.
905 GTK-Doc 1.4 (Jul 3 2005)
908 o Support section documentation (title, short description, long description
909 and 'see also') within the source code. I think everything can now be
910 documented within the source code.
911 o Support Stable/Unstable/Private stability levels for everything.
914 GTK-Doc 1.3 (Jan 9 2005)
917 o Use the new style.css stylesheet instead of hard-wiring the styles.
918 o Updated the documentation and example build files.
919 o Added support for a gallery of widget images.
920 o Output default values for widget properties and allowed ranges.
921 o Only underline links in the docs when the mouse hovers over them.
922 o Added support for placing the parameter table anywhere within the function
923 documentation (using the "<!--PARAMETERS-->" marker).
924 o Handle more variations of C syntax.
927 GTK-Doc 1.2 (Feb 16 2004)
930 o Added widget signals and properties to undocumented output and statistics.
931 o Added support for an index of all symbols.
932 o Emit "Since:" information for signals and properties.
933 o Added derived subclasses and interfaces to the widget hierarchies.
934 o Added .cat SGML catalog file.
935 o Support properties on interfaces.
936 o Added "--help" options to the scripts.
939 GTK-Doc 1.1 (Apr 18 2003)
942 o Add a gtk-doc.m4 macro that allows packages to provide consistent
943 checking for gtk-doc.
944 o Check to make sure that the XML catalog actually contains entries
945 for the DocBook XML DTD and XSLT stylesheets. Please consult the
946 README file if your system's XML catalog isn't set up.
947 o Add infrastructure for including the standard gtk-doc makefile
948 glue, so that maintainers of packages don't need to worry about
949 keeping it up to date. See glib head for an example of its use.
950 o Some updates to the devhelp contents file generation, as suggested
952 o Fix some bugs in the DocBook XML codepath that were preventing
953 inter-module cross references from being resolved.
954 o Fix some bugs in extraction of object property documentation.
957 GTK-Doc 1.0 (Jan 20 2003)
960 o Added support for "Since:" and "Deprecated:" tags, and look for deprecated
961 guard macros in header files.
962 o Support /*< public >*/ and /*< private >*/ markers for all structs.
963 o New "--ignore-files" option for gtkdoc-mkdb, to ignore files or directories.
964 o Used the "sgml-raw" output type with openjade, to avoid problems with Lynx.
965 o Added .pc pkg-config file which can be used to check the gtk-doc version.
968 GTK-Doc 0.10 (Nov 14 2002)
971 o --output-format option to select whether SGML or XML is generated.
972 o Use openjade or jade when converting SGML to HTML.
973 o Use xsltproc to convert XML to HTML, with a new look.
974 o In XML mode, support XIncludes as an alternative to entities.
975 o In XML mode, create .devhelp files.
976 o List interfaces in the object hierarchy.
977 o Create docs for signals on interfaces.
978 o Generate links between interface and their implementations and
980 o Create docs for child and style properties.
981 o Use blurbs for property documentation.
982 o Allow inline documentation for signals and properties.