1 GTK-Doc 1.10 (Mar 20 2008)
6 o 460753 : enable vpath build in gtkdoc-mkhtml
7 o 503119 : Add dependency on content_files to SGML target
8 o 127049 : building reference documentation fails when builddir != s...
9 o 481811 : Inline function bodies are confused with declarations
10 o 448879 : Use a footer when generating HTML documentation
11 o 492005 : Deprecation guard warnings for properties and signals
12 o 498521 : Inconsistent compiler flags passed in gtk-doc.make
13 o 365913 : gtk-doc output is not predictable
14 o 446648 : gtk-doc does not handle forward typedef'd enums
15 o 468278 : Display proper types for properties
16 o 497367 : don't use US-ASCII for output encoding
17 o 501066 : Missing quotes around gtkdoc-rebase check cause a warning
18 o 508897 : [PATCH] Fix build when gtk-doc is not installed
19 o 509539 : Building documentation aborts when no .types file is present
20 o 512154 : Struct member type attributes are limited to one token
21 o 513318 : gtk-doc.el doesn't work fine with emacs22
41 GTK-Doc 1.9 (Sep 30 2007)
46 o 419308 : unsynced regexps for parameter parsing
47 o 449618 : Top navigation bar is in the way
48 o 453717 : fixxref logic to determine absolute path's is flawed
49 o 457173 : unit tests for gtk-doc
50 o 465920 : Use gtkdoc-rebase
51 o 467773 : default master doc should have proper extension
52 o 141869 : Poor error generated when faced with a type declared as '...
53 o 156643 : Avoid make error in gtk-doc.make
54 o 322035 : wrong macro parsing
55 o 323938 : gtk-doc.m4 check is silent
56 o 324535 : gtk-doc doesn't handle deprecation inside enumerations
57 o 355352 : If you don't have an instantiatable type for a gtypeinter...
58 o 379466 : Improve C parser to handle TYPE\nVARIABLE in function pro...
59 o 380824 : docs are truncated if line begins with '* returns '
60 o 383456 : ' make check ' test for 100% documentation
61 o 411739 : Gtk-doc fails to handle ' struct tm * function_name (); '
62 o 415388 : Please clean -undocumented.txt files
63 o 418027 : gtkdoc-mkdb does not handle #ifdef in enum {}
64 o 419997 : parameter name trouble
65 o 428596 : Warnings with gtk-doc.m4 macros
66 o 434134 : fixxrefs like sed for installing pregenerated docs
67 o 436565 : Report undeclared symbols into a file
68 o 445596 : Impossible to link a page with an anchor
69 o 445693 : Does not understand ' unsigned long ' as a type
70 o 450338 : Make gtk-doc.m4 fail when needed gtk-doc is not installed
71 o 454916 : gtk-doc should permit generation of URI-based cross-refer...
72 o 457077 : add --no-implicit-returns to gtkdoc-mkdb
73 o 459225 : Accept automake-1.10 in autogen.sh
74 o 459725 : ' jhbuild build gtk-doc ' fails on make
75 o 460127 : parsing nested union/structs confuses public/private state
76 o 465365 : [PATCH] gtk-doc does not compile
77 o 466559 : [CSS] styling <hr />;
78 o 471014 : G_CONST_RETURN * G_CONST_RETURN * function not picked up
79 o 477532 : function variables
80 o 479913 : gtk-doc.notmpl.make is not distributed
81 o 479923 : distclean test output properly
97 GTK-Doc 1.8 (Feb 16 2007)
100 o Made it easier to include example code in the source code comment blocks.
101 "|[ ... ]|" can be used to delineate example code (it just gets converted
102 to "<informalexample><programlisting>"), and most of the text in example
103 code is left as it is. The only thing that is still expanded is
104 '#' to allow links to a symbol's documentation, e.g. '#GtkWidget'.
105 o Made the field widths wider for the HTML output, so it looks a bit nicer.
106 o Added a '--rebuild-sections' option to gtkdoc-scan to automatically rebuild
107 the MODULE-sections.txt file. This only works if all the header files are
108 organized neatly and functions don't need rearranging in the docs.
109 o Added a '--rebuild-types' option to gtkdoc-scan to automatically rebuild
110 the MODULE.types file, so you don't need to add new types manually.
111 o Leave CDATA sections as they are, in the extra XML content files and within
112 source code comment blocks.
113 o Allow the section id and #include's to be set within the "SECTION:" comment
114 block, using "@Section_ID:xxx" and "@Include:".
115 o Added "--default-includes" option to specify the default #include's (for
116 people who are using --rebuild-sections and so can't specify it in
117 MODULE-sections.txt).
118 o Added a '--query-child-properties' argument to help document child
119 properties of arbitrary GObjects (used by things like canvas widgets).
120 o Fixed documentation of signals of interfaces.
123 GTK-Doc 1.7 (Jul 29 2006)
126 o Fixed bug that resulted in empty "@:" lines in the templates.
127 o Fixed a few bugs with the XSL code.
128 o Supported a few more variations of C syntax.
129 o Remove the internally-used '-struct' suffix from links to widget structs.
130 o Fixed a few missing build dependencies.
131 o Added a new "C-x4s" binding to the emacs lisp code, to insert a blank
132 section header in the source code.
133 o Fixed bug that ignored inline section header docs with '-' in their names.
134 o Added a 'make docs' target that can be used to build the docs even when
135 gtk-doc has been disabled at configure time.
138 GTK-Doc 1.6 (Apr 9 2006)
141 o Removed the hard dependancy on openjade or jade, since XML is used mainly
142 now rather than SGML.
143 o Install the .pc file in $(datadir) rather than $(libdir) since gtk-doc is
144 architecture-independant.
145 o Added "--ignore-decorators" option to ignore a list of declarators in
146 function declarations.
147 o Support '#Object::signal'/'#Object:property' to link to signals/properties
148 o Fixed missing index terms.
151 GTK-Doc 1.5 (Mar 7 2006)
154 o Output the new version of devhelp2 information, but still generate the old
155 devhelp files so older versions of DevHelp still work OK.
156 o Fixed the initial creation of the *-sections.txt file so the object
157 hierarchy, signals and properties all work automatically.
158 o Show information about signal flags (run first/last).
159 o Support a --source-suffixes argument specifying which source files to scan.
160 o Support other root object types besides GObject and GInterface.
161 o Use a fixed navigation bar for the generated documentation.
162 o New documentation from Stefan Kost.
163 o Handle more variations of C syntax.
166 GTK-Doc 1.4 (Jul 3 2005)
169 o Support section documentation (title, short description, long description
170 and 'see also') within the source code. I think everything can now be
171 documented within the source code.
172 o Support Stable/Unstable/Private stability levels for everything.
175 GTK-Doc 1.3 (Jan 9 2005)
178 o Use the new style.css stylesheet instead of hard-wiring the styles.
179 o Updated the documentation and example build files.
180 o Added support for a gallery of widget images.
181 o Output default values for widget properties and allowed ranges.
182 o Only underline links in the docs when the mouse hovers over them.
183 o Added support for placing the parameter table anywhere within the function
184 documentation (using the "<!--PARAMETERS-->" marker).
185 o Handle more variations of C syntax.
188 GTK-Doc 1.2 (Feb 16 2004)
191 o Added widget signals and properties to undocumented output and statistics.
192 o Added support for an index of all symbols.
193 o Emit "Since:" information for signals and properties.
194 o Added derived subclasses and interfaces to the widget hierarchies.
195 o Added .cat SGML catalog file.
196 o Support properties on interfaces.
197 o Added "--help" options to the scripts.
200 GTK-Doc 1.1 (Apr 18 2003)
203 o Add a gtk-doc.m4 macro that allows packages to provide consistent
204 checking for gtk-doc.
205 o Check to make sure that the XML catalog actually contains entries
206 for the DocBook XML DTD and XSLT stylesheets. Please consult the
207 README file if your system's XML catalog isn't set up.
208 o Add infrastructure for including the standard gtk-doc makefile
209 glue, so that maintainers of packages don't need to worry about
210 keeping it up to date. See glib head for an example of its use.
211 o Some updates to the devhelp contents file generation, as suggested
213 o Fix some bugs in the DocBook XML codepath that were preventing
214 inter-module cross references from being resolved.
215 o Fix some bugs in extraction of object property documentation.
218 GTK-Doc 1.0 (Jan 20 2003)
221 o Added support for "Since:" and "Deprecated:" tags, and look for deprecated
222 guard macros in header files.
223 o Support /*< public >*/ and /*< private >*/ markers for all structs.
224 o New "--ignore-files" option for gtkdoc-mkdb, to ignore files or directories.
225 o Used the "sgml-raw" output type with openjade, to avoid problems with Lynx.
226 o Added .pc pkg-config file which can be used to check the gtk-doc version.
229 GTK-Doc 0.10 (Nov 14 2002)
232 o --output-format option to select whether SGML or XML is generated.
233 o Use openjade or jade when converting SGML to HTML.
234 o Use xsltproc to convert XML to HTML, with a new look.
235 o In XML mode, support XIncludes as an alternative to entities.
236 o In XML mode, create .devhelp files.
237 o List interfaces in the object hierarchy.
238 o Create docs for signals on interfaces.
239 o Generate links between interface and their implementations and
241 o Create docs for child and style properties.
242 o Use blurbs for property documentation.
243 o Allow inline documentation for signals and properties.