Doc additions.
[platform/upstream/glib.git] / docs / reference / ChangeLog
index c662f2f..fa8c45b 100644 (file)
@@ -1,3 +1,550 @@
+2004-10-29  Matthias Clasen  <mclasen@redhat.com>
+
+       * glib/tmpl/option.sgml: Add an example.
+
+       * glib/glib-sections.txt: Add G_OPTION_REMAINING
+
+       * glib/tmpl/option.sgml: Add docs.
+
+2004-10-28  Matthias Clasen  <mclasen@redhat.com>
+
+       * glib/tmpl/keyfile.sgml: Add some introductory notes.
+
+2004-10-27 Matthias Clasen  <mclasen@redhat.com>
+
+       * === Released 2.5.4 ===
+
+2004-10-27  Matthias Clasen  <mclasen@redhat.com>
+
+       * glib/tmpl/fileutils.sgml: Add some intro.
+
+2004-10-26  Matthias Clasen  <mclasen@redhat.com>
+
+       * gobject/gobject-docs.sgml: Add an index for 2.6 additions.
+
+       * gobject/gobject-sections.txt: Additions.
+
+       * gobject/Makefile.am (IGNORE_HFILES): Add gobjectalias.h
+
+       * glib/tmpl/main.sgml: Document GChildWatchFunc
+
+       * glib/tmpl/keyfile.sgml: New template.
+
+       * glib/glib-sections.txt: Additions.
+
+       * glib/tmpl/macros_misc.sgml: Document some more of
+       the macros.
+
+2004-10-25  Matthias Clasen  <mclasen@redhat.com>
+
+       * glib/glib-docs.sgml:  Add GKeyFile section, add
+       index for 2.6 additions.
+
+2004-10-23  Matthias Clasen  <mclasen@redhat.com>
+
+       * gobject/tmpl/gtype.sgml (GTypeInterfaceCheckData):
+       Rename first parameter.
+
+       * glib/glib-sections.txt: Add GKeyFile section.
+
+2004-10-17  Matthias Clasen  <mclasen@redhat.com>
+
+       * glib/tmpl/macros.sgml: 
+       * glib/glib-sections.txt: Document G_IS_DIR_SEPARATOR. 
+
+2004-10-05  Matthias Clasen  <mclasen@redhat.com>
+
+       * gobject/tmpl/objects.sgml: Improve the docs for
+       g_object_get_property().  (#153424, Stefan Kost)
+
+2004-10-03  Matthias Clasen  <mclasen@redhat.com>
+
+       * gobject/tmpl/signals.sgml: Improve docs for 
+       g_signal_add_emission_hook.  (#154299, Nickolay V. Shmyrev)
+
+2004-09-20  Matthias Clasen  <mclasen@redhat.com>
+
+       * glib/tmpl/messages.sgml: Correct the docs for the default log
+       handler wrt to which messages go to stderr. (#153041, Philippe Blain)
+
+Sun Sep 19 23:15:17 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/tmpl/patterns.sgml: Point to g_utf8_strreverse() for
+       reversing UTF-8 strings.  (#153091, Adam Hooper)
+
+2004-09-18  Matthias Clasen  <mclasen@redhat.com>
+
+       * === Released 2.5.3 ===
+
+2004-09-16  Matthias Clasen  <mclasen@redhat.com>
+
+       * glib/Makefile.am: Ignore galias.h
+
+       * glib/glib-sections.txt: Updates.
+
+2004-09-09  Matthias Clasen  <mclasen@redhat.com>
+
+       * glib/tmpl/misc_utils.sgml: Add a hint about $HOME to the
+       docs of g_get_home_dir().
+
+Thu Sep  9 00:11:19 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/glib-sections.txt: Add g_strv_length().
+
+2004-09-07  Matthias Clasen  <mclasen@redhat.com>
+
+       * glib/glib-sections.txt: Add g_get_language_names().
+
+Mon Sep  6 01:56:13 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/tmpl/messages.sgml: Remove excess markup and fix a markup
+       error.
+
+Sun Sep  5 01:44:23 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/glib-sections.txt: 
+       * glib/tmpl/messages.sgml: Document g_log_set_default_handler().
+
+Wed Sep  1 20:27:59 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/glib-sections.txt: Add g_date_get_iso8601_week_of_year.
+
+Sun Aug 29 23:50:45 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/tmpl/fileutils.sgml: Fix a typo.  (#151109, Stepan Kasal)
+
+2004-08-27  Matthias Clasen  <mclasen@redhat.com>
+
+       * glib/tmpl/fileutils.sgml: Add G_FILE_ERROR_NOSYS.
+
+2004-08-25 Matthias Clasen  <mclasen@redhat.com>
+
+       * === Released 2.5.2 ===
+
+2004-08-23  Matthias Clasen  <mclasen@redhat.com>
+
+       * glib/tmpl/warnings.sgml: Add an example for
+       g_on_error_query() usage.  (#148716, Christian Persch)
+
+2004-08-12  Matthias Clasen  <mclasen@redhat.com>
+
+       * glib/tmpl/threads.sgml: Document the necessity to call
+       g_thread_init() when using threads 
+       (even non-gthreads).  (#149490, Vincent Untz)
+
+
+Tue Aug  3 16:43:22 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/glib-sections.txt: Add a section for GOption.
+       * glib/glib-docs.sgml: Include GOption section.
+       * glib/tmpl/option.sgml: New template.
+
+Tue Aug  3 15:34:16 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/glib-sections.txt: Add a separate section for
+       version information.
+       * glib/glib-docs.sgml: Include version section.
+       * glib/tmpl/version.sgml: New template.
+
+2004-08-02  Matthias Clasen  <mclasen@redhat.com>
+
+       * glib/glib-sections.txt: 
+       * glib/tmpl/macros_misc.sgml: Document G_GNUC_INTERNAL.
+
+2004-08-01 Matthias Clasen  <mclasen@redhat.com>
+
+       * === Released 2.5.1 ===
+
+2004-07-28  Matthias Clasen  <mclasen@redhat.com>
+
+       * glib/tmpl/misc_utils.sgml: Clarify docs for 
+       g_get_real_name().  (#143552, Danek Duvall)
+
+Fri Jul 23 10:38:24 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/tmpl/limits.sgml: Fix docs for G_MAXSIZE.  (#148262, 
+       Christophe Fergeau)
+
+Sun Jul 18 18:03:08 2004  Soeren Sandmann  <sandmann@daimi.au.dk>
+
+       * === Released 2.5.0 ===
+
+2004-07-09  Matthias Clasen  <mclasen@redhat.com>
+
+       * glib/tmpl/arrays.sgml: Improve g_array_free() docs.  (#146875,
+       Ed Griffiths)
+
+Tue Jul  6 00:54:38 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/gobject-sections.txt: 
+       * gobject/tmpl/gtypemodule.sgml: Add g_type_module_register_enum()
+       and g_type_module_register_flags().
+
+Mon Jul  5 18:49:56 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/tmpl/messages.sgml: 
+       * glib/glib-sections.txt: Add g_debug.
+
+2004-06-15  Federico Mena Quintero  <federico@ximian.com>
+
+       * glib/tmpl/conversions.sgml: New section on file name encodings.
+
+       * glib/file-name-encodings.sxd: New diagram of how file name
+       encodings work.
+
+       * glib/file-name-encodings.png: Same as above, for inclusion in
+       the generated docs.
+
+       * glib/Makefile.am (HTML_IMAGES): Add file-name-encodings.png.
+       (EXTRA_DIST): Add the new images.
+
+       * glib/running.sgml: Add ids to the corresponding paragraphs that
+       describe G_FILENAME_ENCODING and G_BROKEN_FILENAMES, to be able to
+       reference them from elsewhere.
+
+Thu Jun 10 21:29:55 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/tmpl/modules.sgml: Add an example for GModule
+       usage.  (#144127, Tommi Komulainen)
+
+Sun Jun  6 23:20:42 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/tmpl/gtype.sgml: Fix the docs for G_DEFINE_TYPE()
+       and friends.  (#143800, Crispin Flowerday)
+
+2004-05-05  Matthias Clasen  <mclasen@redhat.com>
+
+       * gobject/gobject-docs.sgml: 
+       * glib/glib-docs.sgml: Add multiple indices.
+
+2004-04-30  Matthias Clasen  <mclasen@redhat.com>
+
+       * === Released 2.4.1 ===
+
+2004-04-23  Matthias Clasen  <mclasen@redhat.com>
+
+       * glib/running.sgml: Document LIBCHARSET_ALIAS_DIR.
+
+2004-04-15  Matthias Clasen  <mclasen@redhat.com>
+
+       * glib/tmpl/types.sgml: Correct the description of the
+       gfloat and gdouble ranges.
+
+Tue Mar 16 12:06:09 2004  Owen Taylor  <otaylor@redhat.com>
+
+       * === Released 2.4.0 ===
+       
+Sun Mar 14 11:00:41 2004  Owen Taylor  <otaylor@redhat.com>
+
+       * gobject/tmpl/signals.sgml: Document the fact that
+       g_signal_connect_object() does *not* remove the signal
+       when the object is disconnected currently and describe
+       a workaround to prevent memory leaks.
+
+Tue Mar  9 09:16:11 2004  Owen Taylor  <otaylor@redhat.com>
+
+       * === Released 2.3.6 ===
+
+Mon Mar  8 08:32:36 2004  Owen Taylor  <otaylor@redhat.com>
+
+       * glib/tmpl/main.sgml: Reference g_source_set_callback(),
+       not g_source_attach(). (Takeshi AIHANA)
+
+2004-02-29  Sebastian Wilhelmi  <seppi@seppi.de>
+
+       * glib/glib-overrides.txt, glib/glib-sections.txt,
+       glib/tmpl/atomic_operations.sgml: Updated according to code changes.
+
+Sun Feb 29 02:35:00 2004  Sven Herzberg  <herzi@gnome-de.org>
+
+       * glib/tmpl/limits.sgml: exchange non-existing G_MAX_DOUBLE for
+       G_MAXDOUBLE (fixes #135723)
+
+Fri Feb 27 22:10:25 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/tmpl/modules.sgml: Reformat a bit.
+
+Fri Feb 27 22:05:23 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/tmpl/limits.sgml: Document G_MAXSIZE.
+
+2004-02-26  Sebastian Wilhelmi  <seppi@seppi.de>
+
+        * glib/tmpl/threads.sgml: Updated to reflect removal of the PID
+       niceness surrogate for thread priorities.
+
+       * glib/glib-overrides.txt, glib/glib-sections.txt,
+       glib/glib-docs.sgml, glib/tmpl/atomic_operations.sgml: Add docs
+       for atomic operations.
+
+Tue Feb 24 14:09:21 2004  Owen Taylor  <otaylor@redhat.com>
+
+       * === Released 2.3.3 ===
+
+       * glib/glib-sections.txt: Updates.
+
+Sun Feb 22 00:59:11 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/tmpl/trees-nary.sgml: Document GCopyFunc.
+
+Sun Feb 22 00:54:17 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/glib-sections.txt: Add GCopyFunc and g_node_copy_deep.
+
+2004-02-18  Sebastian Wilhelmi  <seppi@seppi.de>
+
+       * glib/glib-sections.txt: Add the new g_rand_* functions
+
+Sat Feb 14 01:25:23 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/glib-sections.txt: Add GPid, GChildWatchFunc,
+       g_child_watch_source_new, g_child_watch_add,
+       g_child_watch_add_full.
+
+Fri Feb 13 23:16:25 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/tmpl/macros_misc.sgml: Fix a typo. 
+
+Sat Feb  7 01:02:06 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/tmpl/numerical.sgml: Fix some external links.
+
+Thu Feb  5 00:54:43 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/glib-sections.txt: Add g_completion_complete_utf8.
+
+Fri Jan 30 23:25:58 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/tmpl/iochannels.sgml: 
+       * glib/tmpl/main.sgml: Remove references to deprecated GTK+ and
+       GDK functions.  (#130756, Vincent Untz)
+       
+Wed Jan 28 01:39:59 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/glib-sections.txt: Add g_strsplit_set. (Soeren Sandmann)
+
+Thu Jan 22 14:51:19 2004  Owen Taylor  <otaylor@redhat.com>
+
+       * glib/glib-sections.txt glib/tmpl/timers.sgml: Document
+       g_timer_continue. (Tim-Philipp Müller)
+
+Sun Jan 11 01:25:44 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/tmpl/gtype.sgml: Improve docs for G_DEFINE_TYPE_* macros.
+
+Sun Jan 11 01:25:29 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/gobject-sections.txt: Add G_DEFINE_TYPE_EXTENDED.
+
+Sat Jan 10 02:18:32 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/tmpl/gtype.sgml: Document the new GType boilerplate macros
+       with an example.
+
+Sat Jan 10 01:36:01 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/tmpl/gtype.sgml: Document g_type_class_peek_static.
+
+Sat Jan 10 01:23:58 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/gobject-sections.txt: Add g_type_class_peek_static,
+       G_DEFINE_TYPE, G_DEFINE_TYPE_WITH_CODE, G_DEFINE_ABSTRACT_TYPE,
+       G_DEFINE_ABSTRACT_TYPE_WITH_CODE, G_IMPLEMENT_INTERFACE.
+
+
+Sat Jan 10 01:23:01 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/tmpl/objects.sgml: Update docs of g_object_connect.
+
+Fri Jan  9 23:40:23 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/tmpl/gboxed.sgml: 
+       * gobject/gobject-sections.txt: Add G_TYPE_STRV and GStrv.
+
+Fri Dec 26 02:04:49 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/glib-sections.txt: Add g_ptr_array_foreach().
+
+Sun Dec 21 01:01:34 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/tmpl/misc_utils.sgml: Document the encoding of 
+       g_get_real_name().
+
+Fri Dec 19 21:40:00 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/tmpl/signals.sgml: Rewording.
+
+Tue Dec  2 02:31:15 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/tmpl/limits.sgml:
+       * glib/glib-sections.txt: Add G_{MIN,MAX,MAXU}INT{8,16,32}.
+
+Thu Nov  6 01:42:36 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/glib-sections.txt: Add an i18n section.
+       * glib/glib-docs.sgml: Include the corresponding entity.
+       * glib/tmpl/i18n.sgml: Template for i18n section.
+
+Thu Nov  6 00:56:04 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * glib/running.sgml: Document G_FILENAME_ENCODING.
+
+Sat Oct 25 01:07:45 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/tmpl/gparamspec.sgml: 
+       * gobject/tmpl/objects.sgml: Additions.
+
+Thu Oct 23 14:27:54 2003  Owen Taylor  <otaylor@redhat.com>
+
+       * gobject/Makefile.am: Add a dist-hook so that the
+       man pages get distributed.
+
+       * glib/Makefile.am: Add a dist-hook so that the
+       man pages get distributed.
+
+       * glib/Makefile.am (content_files): Add cross.sgml.
+
+       * gobject/Makefile.am (INCLUDES): Add $(top_srcdir)/glib,
+       and (for gobject.cI) $(srcdir)
+
+Tue Oct 21 23:29:54 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/tmpl/gtypemodule.sgml: 
+       * gobject/tmpl/enumerations_flags.sgml: 
+       * gobject/tmpl/gtype.sgml: Additions.
+
+Tue Oct 21 23:09:15 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/tmpl/gparamspec.sgml: 
+       * gobject/tmpl/param_value_types.sgml:
+       * gobject/tmpl/gtype.sgml: 
+       * gobject/tmpl/signals.sgml: Add "Since 2.4" markers where
+       appropriate.
+
+Tue Oct 14 17:45:33 2003  Owen Taylor  <otaylor@redhat.com>
+
+       * gobject/gobject-sections.txt gobject/tmpl/objects.sgml
+       gobject/tmpl/param_value_types.sgml gobject/tmpl/gparamspec.sgml:
+       Document interface properties and GParamSpecOverride.
+
+Mon Oct 20 22:05:37 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/tmpl/objects.sgml: 
+       * gobject/tmpl/enumerations_flags.sgml: 
+       * gobject/tmpl/gtypeplugin.sgml: Additions.
+
+Mon Oct 20 22:04:45 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/gobject-sections.txt: Add GObjectConstructParam.
+
+Mon Oct 20 20:38:06 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/gobject.i: Removed...
+       * gobject/gobject.cI: ...and readded.
+       * gobject/gobject.types: Change to the standard file 
+       extension for included hunks of C code.
+
+Mon Oct 20 20:34:33 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/Makefile.am (INCLUDES): Add $(top_builddir)/glib
+       as an include dir again, this time for real.  
+
+Mon Oct 20 01:12:46 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/tmpl/gtype.sgml: 
+       * gobject/tmpl/param_value_types.sgml: 
+       * gobject/tmpl/value_arrays.sgml: Additions.
+
+       * gobject/tmpl/gboxed.sgml: 
+       * gobject/gobject-sections.txt: Remove prematurely added
+       GStrv documentation.
+
+Sun Oct 19 22:18:28 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/Makefile.am (INCLUDES): Add $(top_builddir)/glib
+       as an include dir.  (#124934, Mariano Suárez-Alvarez)
+
+Sun Oct 19 00:33:28 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/tmpl/gtype.sgml: 
+       * gobject/tmpl/generic_values.sgml: 
+       * gobject/tmpl/objects.sgml: 
+       * gobject/tmpl/signals.sgml: Additions.
+
+Sat Oct 18 01:30:47 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/tmpl/gboxed.sgml: 
+       * gobject/tmpl/gtypeplugin.sgml: 
+       * gobject/tmpl/enumerations_flags.sgml: Additions.
+
+Sat Oct 18 00:04:22 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/gobject.types: List GObject here, since the
+       documentation misses the notify signal otherwise. Needs
+       a little bit of a hack to work around a gtkdoc-scangobj
+       limitation, see the comment in gobject/gobject.i.
+
+       * gobject/gobject.i: New file, containing a trivial 
+       g_object_get_type() function.
+       
+Fri Oct 17 00:23:51 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/Makefile.am (GTKDOC_LIBS): 
+       (INCLUDES): Add the necessary stuff to compile gobject-scan.
+
+       * gobject/gobject.types: Add g_type_module_get_type() and
+       g_type_plugin_get_type().
+
+Thu Oct 16 01:02:04 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/tmpl/gparamspec.sgml: Additions, document 
+       GParamSpecPool.
+
+Wed Oct 15 00:56:30 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/tmpl/gclosure.sgml: Improvements from Owen's feedback. 
+
+Tue Oct 14 02:35:45 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/gobject-sections.txt: Move the g_cclosure_marshal_*
+       functions to a non-private subsection, since these functions
+       are not private.
+
+Tue Oct 14 02:35:16 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/tmpl/gclosure.sgml: Fill in.
+
+Sun Oct  5 23:23:53 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/glib-sections.txt: 
+       * gobject/gobject-sections.txt: Fix includes.
+
+       * gobject/tmpl/value_collection.sgml: Add docs found in the 
+       header.
+
+Thu Oct  2 01:22:46 2003  Owen Taylor  <otaylor@redhat.com>
+
+       * gobject/gobject-sections.txt gobject/tmpl/gtype.sgml: 
+       Add g_type_add/remove_interface_check()
+
+2003-09-30  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/tmpl/gparamspec.sgml: 
+       * gobject/tmpl/signals.sgml: Additions.
+
+       * glib/glib-sections.txt: Add g_unichar_get_mirror_char and
+       g_static_mutex_get_mutex_impl_shortcut.
+
+Mon Sep 29 10:55:23 2003  Owen Taylor  <otaylor@redhat.com>
+
+       *  gobject/gobject-sections.txt gobject/tmpl/gtype.sgml:
+       Docs for g_type_default_interface_ref(), etc.
+
+Fri Sep 12 16:29:29 2003  Owen Taylor  <otaylor@redhat.com>
+
+       * gobject/tmpl/signals.sgml: Add docs for
+       g_signal_accumulator_true_handled.
+
 2003-09-12  Matthias Clasen  <maclas@gmx.de>
 
        * gobject/gobject-sections.txt: Add new g_value_take_x() functions.