Commit Graph

289 Commits

Author SHA1 Message Date
Matthias Clasen
0f563c0f26 Some rewording. 2003-12-19 20:39:37 +00:00
Matthias Clasen
04c96e8fa3 Fix for #103710, Mark Jones:
Tue Dec  2 02:29:41 2003  Matthias Clasen  <maclas@gmx.de>

	Fix for #103710, Mark Jones:

	* glib/gtypes.h (G_MAXINT64): Define G_{MIN,MAX,MAXU}INT{8,16,32,64}.
	* configure.in: Don't put G_{MIN,MAX,MAXU}INT64 in glibconfig.h.
2003-12-02 01:31:43 +00:00
Matthias Clasen
fa65fd554b Add an i18n section. Include the corresponding entity. Template for i18n
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.
2003-11-06 00:43:48 +00:00
Matthias Clasen
eb9b3fbdeb 100% 2003-10-24 23:10:37 +00:00
Owen Taylor
dfa8c540a1 === Released 2.3.0 ===
Thu Oct 23 12:38:24 2003  Owen Taylor  <otaylor@redhat.com>

        * === Released 2.3.0 ===

        * tests/gobject/Makefile.am (dist-hook): Remove
        and extra backslash.

        * tests/gobject/Makefile.am (EXTRA_DIST): Add
        testmarshal.list.

        * glib/Makefile.am (libglib_2_0_la_SOURCES): Add
        missing gunicode-private.h.

        * tests/testglib.c (main): Fix a warning.

        * tests/gobject/ifaceinherit.c: Remove check that
        wasn't supposed to work (adding an interface already
        added to the derived class to the base class),
        fix a bug.
2003-10-23 22:42:31 +00:00
Matthias Clasen
d619ee159b Additions.
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.
2003-10-21 21:49:21 +00:00
Matthias Clasen
28f255d1d0 Add "Since 2.4" markers where appropriate.
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.
2003-10-21 21:10:26 +00:00
Owen Taylor
4d3e3f0bd9 Document interface properties and GParamSpecOverride.
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.
2003-10-21 19:14:04 +00:00
Matthias Clasen
4a29291187 Documentation additions. 2003-10-20 20:07:45 +00:00
Matthias Clasen
04d27d2299 Removed... ...and readded. Change to the standard file extension for
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.
2003-10-20 18:40:00 +00:00
Matthias Clasen
ad23d7bb7f Additions.
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.
2003-10-19 23:17:30 +00:00
Matthias Clasen
702fc02f8f Add $(top_builddir)/glib as an include dir. (#124934, Mariano
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)
2003-10-19 20:20:17 +00:00
Matthias Clasen
2c12a01665 Additions.
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.
2003-10-18 22:55:00 +00:00
Matthias Clasen
0cbbe0bcdf Add /*< public >*/ and /*< private >*/ markers for documentation purposes.
Sat Oct 18 01:30:47 2003  Matthias Clasen  <maclas@gmx.de>

	* gtypeplugin.h (struct _GTypePluginClass): Add /*< public >*/
	and /*< private >*/ markers for documentation purposes.

	* gobject/tmpl/gboxed.sgml:
	* gobject/tmpl/gtypeplugin.sgml:
	* gobject/tmpl/enumerations_flags.sgml: Additions.
2003-10-17 23:33:03 +00:00
Matthias Clasen
a414fb77de List GObject here, since the documentation misses the notify signal
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.
2003-10-17 22:08:04 +00:00
Matthias Clasen
7681dc412e Add the necessary stuff to compile gobject-scan.
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().
2003-10-16 22:24:57 +00:00
Matthias Clasen
6e5ded7781 Additions, document GParamSpecPool.
Thu Oct 16 01:02:04 2003  Matthias Clasen  <maclas@gmx.de>

	* gobject/tmpl/gparamspec.sgml: Additions, document
	GParamSpecPool.
2003-10-15 23:03:20 +00:00
Matthias Clasen
4dd7b60fb9 Improvements from Owen's feedback.
* gobject/tmpl/gclosure.sgml: Improvements from Owen's feedback.
2003-10-14 22:57:32 +00:00
Matthias Clasen
9d641fd17a Document closures. 2003-10-14 00:37:18 +00:00
Matthias Clasen
1a197c35c3 Fix includes.
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.
2003-10-05 21:32:09 +00:00
Owen Taylor
3963846335 Add g_type_add/remove_interface_check()
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-10-02 05:25:32 +00:00
Matthias Clasen
dd012cc3ed Additions.
2003-09-30  Matthias Clasen  <maclas@gmx.de>

	* gobject/tmpl/gparamspec.sgml:
	* gobject/tmpl/signals.sgml: Additions.
2003-09-29 22:48:05 +00:00
Matthias Clasen
712c9d672e Add "Since: 2.4" to docs. Add g_unichar_get_mirror_char and
2003-09-29  Matthias Clasen  <maclas@gmx.de>

	* glib/guniprop.c (g_unichar_get_mirror_char): Add "Since: 2.4"
	to docs.
	* glib/glib-sections.txt: Add g_unichar_get_mirror_char and
	g_static_mutex_get_mutex_impl_shortcut.
2003-09-29 22:04:28 +00:00
Owen Taylor
4cfce6290b Docs for g_type_default_interface_ref(), etc. :
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.
: ----------------------------------------------------------------------
2003-09-29 14:56:23 +00:00
Owen Taylor
89e16ea9c7 Add docs for g_signal_accumulator_true_handled.
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 20:37:29 +00:00
Matthias Clasen
c3acb9da0c Make the g_value_set_x_take_ownership() functions "official" part of the
2003-09-12  Matthias Clasen  <maclas@gmx.de>

	Make the g_value_set_x_take_ownership() functions "official"
	part of the API (#100948):

	* gvaluetypes.[hc]: Add g_value_take_string() (synonym to the
	now deprecated g_value_set_string_take_ownership()).

	* gparam.[hc]: Add g_value_take_param() (synonym to the
	now deprecated g_value_set_param_take_ownership()).

	* gobject.[hc]: Add g_value_take_object() (synonym to the
	now deprecated g_value_set_object_take_ownership()).

	* gboxed.[hc]: Add g_value_take_boxed() (synonym to the
	now deprecated g_value_set_boxed_take_ownership()).

	* gobject/gobject-sections.txt: Add new g_value_take_x() functions.

	* gobject/tmpl/param_value_types.sgml: Document new g_value_take_x()
	functions.  (#100948)
2003-09-12 20:11:38 +00:00
Matthias Clasen
10d02e3aef Add note about in-place editing to g_strdelimit() doc.
(#118875, Thomas Vander Stichele)
2003-08-05 21:35:55 +00:00
Matthias Clasen
b3814b0cdc Small doc additions. 2003-07-30 19:00:36 +00:00
Matthias Clasen
beca86c32b Small doc fixes. 2003-07-30 18:50:26 +00:00
Matthias Clasen
e7fde02e4f Add paragraph about multi-threading policy.
* glib/glib-docs.sgml: Add paragraph about multi-threading policy.
2003-07-29 22:37:37 +00:00
Matthias Clasen
15edef6ff2 Rename g_read_link() to g_file_read_link() to better match the remaining
* glib/gfileutils.[hc]: Rename g_read_link() to g_file_read_link() to better match the remaining file
	utilities in the g_file_ namespace and to better separate it from readlink(). This is hopefully no problem
	as the function is just 2 days old.
2003-07-29 22:31:40 +00:00
Matthias Clasen
3c51de64fe Integrate gnulib vasnprintf(). 2003-07-28 23:00:05 +00:00
Matthias Clasen
355eb38190 New function g_read_link(). (#72545)
* glib/gfileutils.h:
	* glib/gfileutils.c: New function g_read_link(). (#72545)
2003-07-28 19:49:47 +00:00
Matthias Clasen
f723402708 Add g_setenv() and g_unsetenv(). (#100763)
* glib/gutils.[ch]: Add g_setenv() and g_unsetenv().  (#100763)
2003-07-28 19:24:22 +00:00
Matthias Clasen
971af34af9 New functions to remove a range of elements from an array. (#94879, Nalin
2003-07-26  Matthias Clasen  <maclas@gmx.de>

	* glib/garray.h:
	* glib/garray.c (g_{,byte,pointer}_remove_range): New functions to remove a range of elements
	from an array.  (#94879, Nalin Dahyabhai)
2003-07-26 08:03:16 +00:00
Matthias Clasen
ffa186dfc9 Remove the 1024 char limit in the common (non-recursive) case.
2003-07-26  Matthias Clasen  <maclas@gmx.de>

	* glib/gmessages.c (g_logv): Remove the 1024 char limit in the common (non-recursive)
	case.
2003-07-25 23:17:23 +00:00
Matthias Clasen
8f74a6a78a Mention the restriction on message length. (#118043, Martyn Russell)
* glib/tmpl/messages.sgml: Mention the restriction on message length.  (#118043, Martyn Russell)
2003-07-23 22:41:23 +00:00
Matthias Clasen
27da11aa5a Add a note about double indirection in g_ptr_array_sort[_with_data]().
2003-07-18  Matthias Clasen  <maclas@gmx.de>

	* glib/tmpl/arrays_pointer.sgml: Add a note about double indirection in
	g_ptr_array_sort[_with_data]().  (#113697, Owen Taylor)
2003-07-17 23:11:21 +00:00
Matthias Clasen
238c7c368b Doc additions.
2003-07-12  Matthias Clasen  <maclas@gmx.de>

	* glib/gprintf.c: Doc additions.

2003-07-12  Matthias Clasen  <maclas@gmx.de>

	* glib/tmpl/string_utils.sgml: Add a paragraph about string precision, add links to it.
	Remove markup which is now handled better by gtk-doc.
2003-07-08 23:43:47 +00:00
Matthias Clasen
fe5c4f3e50 Support for one-time initialization functions. (#69668, Sebastian
2003-07-09  Matthias Clasen  <maclas@gmx.de>

	Support for one-time initialization functions.  (#69668, Sebastian Wilhelmi)

	* configure.in: Check whether double checked locking is safe, define g_once() in
	glibconfig.h accordingly.
	* glib/gthread.h: Add GOnce, GOnceStatus, G_ONCE_INIT and g_once_impl.
	* glib/gthread.c (g_once_impl): Fallback implementation using a mutex if double checked
	locking is unsafe.
	* tests/thread-test.c: Add tests for g_once().
2003-07-08 23:43:47 +00:00
Matthias Clasen
8940b82eb4 Move g_strfreev() docs inline.
2003-07-02  Matthias Clasen  <maclas@gmx.de>

	* glib/tmpl/string_utils.sgml: Move g_strfreev() docs inline.
2003-07-01 22:15:54 +00:00
Matthias Clasen
67c48e49ee Move the documentation inline and add details. (#108505) Move
2003-06-19  Matthias Clasen  <maclas@gmx.de>

	* glib/gutils.c (g_path_get_basename): Move the documentation
	inline and add details.  (#108505)
	* glib/tmpl/misc_utils.sgml: Move g_path_get_basename() docs inline.
2003-06-18 23:12:56 +00:00
Matthias Clasen
be019f685f Add g_thread_init_glib to silence gtk-doc.
* glib/glib-sections.txt: Add g_thread_init_glib to silence gtk-doc.
2003-06-18 21:47:16 +00:00
Matthias Clasen
54f796b1b6 New macros to check for XML catalog contents and path, borrowed from
2003-06-17  Matthias Clasen  <maclas@gmx.de>

	* acinclude.m4 (JH_PATH_XML_CATALOG, JH_CHECK_XML_CATALOG): New
	macros to check for XML catalog contents and path, borrowed from
	gtk-doc.
	* configure.in: New option --enable-man to enable regeneration of
	man pages from Docbook, if the necessary tools are found.

	* gobject/Makefile.am: Add rule to regenerate man pages from
	Docbook.
	(man_MANS): Add glib-mkenums.1, glib-genmarshal.1 and gobject-query.1.
	(content_files): Add glib-mkenums.xml, glib-genmarshal.xml and
	gobject-query.xml.

	* gobject/glib-mkenums.xml:
	* gobject/glib-genmarshal.xml:
	* gobject/gobject-query.xml: New refentries.

	* gobject/glib-mkenums.1:
	* gobject/glib-genmarshal.1:
	* gobject/gobject-query.1: Man pages generated from the .xml
	sources.

	* gobject/gobject-docs.sgml: Include glib-mkenums.xml,
	glib-genmarshal.xml and gobject-query.xml.

	* glib/Makefile.am: Add rule to regenerate man pages from
	Docbook.
	(man_MANS): Add glib-gettextize.1.
	(content_files): Add glib-gettextize.xml.

	* glib/glib-gettextize.xml: New refentry.

	* glib/glib-gettextize.1: Man page generated from the .xml source.

	* glib/glib-docs.sgml: Include glib-gettextize.xml.
2003-06-17 23:08:37 +00:00
Matthias Clasen
6411bedd01 Add an autogenerated index.
2003-06-17  Matthias Clasen  <mc2@YAST_ASK>

	* gobject/gobject-docs.sgml:
	* glib/glib-docs.sgml: Add an autogenerated index.

2003-06-17  Matthias Clasen  <maclas@gmx.de>

	* glib/tmpl/macros_misc.sgml: Document G_GNUC_DEPRECATED.
2003-06-16 23:01:00 +00:00
Matthias Clasen
34d2573657 A small addition.
2003-06-11  Matthias Clasen  <maclas@gmx.de>

	* gobject/tmpl/objects.sgml: A small addition.
2003-06-11 21:18:55 +00:00
Owen Taylor
1c5f52baa2 XML fix.
Sun Jun  8 12:28:39 2003  Owen Taylor  <otaylor@redhat.com>

        * glib/tmpl/error_reporting.sgml: XML fix.

        * glib/glib-sections.txt: Updated.
2003-06-08 16:35:16 +00:00
Matthias Clasen
a495b2cb03 Correct the documentation for G_MINFLOAT and G_MINDOUBLE. (#114513,
* glib/tmpl/limits.sgml: Correct the documentation for
	G_MINFLOAT and G_MINDOUBLE.  (#114513, Christophe Fergeau)
2003-06-06 21:20:34 +00:00
Matthias Clasen
53efcd835d Add g_vasprintf().
2003-06-06  Matthias Clasen  <maclas@gmx.de>

	* glib/glib-sections.txt: Add g_vasprintf().

	* glib/tmpl/string_utils.sgml: Add a hint about g_vasprintf() to
	the g_strdup_printf() docs.
2003-06-05 22:54:55 +00:00
Matthias Clasen
d1db6f8b36 Document that g_strdup() and g_strndup() accept NULL. (#106987, Christian
2003-05-28  Matthias Clasen  <maclas@gmx.de>

	* glib/tmpl/string_utils.sgml: Document that g_strdup() and
	g_strndup() accept NULL.  (#106987, Christian Biere)
2003-05-27 22:25:03 +00:00
Matthias Clasen
a45782e8ee Fix a duplicate id left by copy-and-paste. (#112785, Owen Taylor)
2003-05-12  Matthias Clasen  <maclas@gmx.de>

	* glib/cross.sgml: Fix a duplicate id left by copy-and-paste.
	(#112785, Owen Taylor)
2003-05-11 22:29:50 +00:00
Matthias Clasen
b9415110b1 Correct the documentation GSignalEmissionHook (#110906) and some cleanups.
2003-04-18  Matthias Clasen  <maclas@gmx.de>

	* gobject/tmpl/signals.sgml: Correct the documentation
	GSignalEmissionHook (#110906) and some cleanups.
2003-04-18 00:17:16 +00:00
Matthias Clasen
890792db1a Fix a few typos. 2003-04-11 21:56:50 +00:00
Matthias Clasen
754d18b050 Move install docs into reference manual. 2003-04-09 18:49:48 +00:00
Matthias Clasen
7b0da6c54a Move cross-compilation info to reference manual. 2003-04-07 23:20:57 +00:00
Matthias Clasen
91da77c5b4 Additions. 2003-04-07 00:08:19 +00:00
Matthias Clasen
aad05b82e0 Fix formatting of examples.
2003-04-01  Matthias Clasen  <maclas@gmx.de>

	* glib/tmpl/error_reporting.sgml:
	* glib/tmpl/random_numbers.sgml:
	* glib/tmpl/arrays_pointer.sgml:
	* glib/tmpl/arrays.sgml: Fix formatting of examples.
2003-03-31 22:51:28 +00:00
Matthias Clasen
e4112b8b1b New function, to insert possible non-nul-terminated byte sequences into a
2003-04-01  Matthias Clasen  <maclas@gmx.de>

	* glib/gstring.[hc] (g_string_chunk_insert_len): New function, to
	insert possible non-nul-terminated byte sequences into a string
	chunk.  (#96279)
	(g_string_chunk_insert): Implement in terms of
	g_string_chunk_insert_len() now.
2003-03-31 22:08:08 +00:00
Matthias Clasen
46ae53a931 Additions. 2003-03-27 23:17:59 +00:00
Matthias Clasen
dfa521fdf7 Additions. 2003-03-24 23:28:35 +00:00
Matthias Clasen
e35363d894 Additions.
2003-03-24  Matthias Clasen  <maclas@gmx.de>

	* gobject/tmpl/objects.sgml: Additions.
2003-03-24 01:10:28 +00:00
Owen Taylor
e6d15f6eaf Document private instance data.
Mon Mar 10 11:33:10 2003  Owen Taylor  <otaylor@redhat.com>

        * gobject/tmpl/gtype.sgml gobject/gobject-sections.txt:
        Document private instance data.
2003-03-10 16:38:58 +00:00
Matthias Clasen
9796402280 Fix an off-by-one error in the g_strescape() docs. (#105431, Phillip
2003-02-11  Matthias Clasen  <maclas@gmx.de>

	* glib/tmpl/string_utils.sgml: Fix an off-by-one error in the
	g_strescape() docs.  (#105431, Phillip Vandry)
2003-02-10 23:56:45 +00:00
Matthias Clasen
280a213b09 Move all docs out-of-line. Boy, what a waste of time.
2003-02-07  Matthias Clasen  <maclas@gmx.de>

	* gobject/tmpl/gtypemodule.sgml:
	* gobject/tmpl/gtype.sgml:
	* gobject/tmpl/gclosure.sgml:
	* gobject/tmpl/param_value_types.sgml:
	* gobject/tmpl/gparamspec.sgml:
	* gobject/tmpl/objects.sgml:
	* gobject/tmpl/signals.sgml: Move all docs out-of-line. Boy, what
	a waste of time.
2003-02-07 22:08:53 +00:00
Matthias Clasen
d671206b9e Document the return value of g_string_free().
2003-01-21  Matthias Clasen  <maclas@gmx.de>

	* glib/tmpl/strings.sgml: Document the return value of g_string_free().
2003-01-21 22:24:00 +00:00
Matthias Clasen
7b5bfca305 Fix the description of G_TYPE_FUNDAMENTAL. (#103119, Josh Parsons)
2003-01-15  Matthias Clasen  <maclas@gmx.de>

	* gobject/tmpl/gtype.sgml: Fix the description of
	G_TYPE_FUNDAMENTAL.  (#103119, Josh Parsons)
2003-01-14 23:38:34 +00:00
Tor Lillqvist
7809df2a6a Remove comment that only stdout would be used on Windows, no longer true.
2003-01-01  Tor Lillqvist  <tml@iki.fi>

	* glib/tmpl/messages.sgml: Remove comment that only stdout would
	be used on Windows, no longer true.
2003-01-01 01:40:52 +00:00
Matthias Clasen
8b8616bb9c Move some docs inline.
* gobject/tmpl/param_value_types.sgml: Move some docs inline.

	* gsignal.c (g_signal_new): Typo fix.

	* gparamspecs.c:
	* gparam.c (g_param_spec_internal):
	* gobject.c (g_object_class_install_property): Add docs.
2002-12-15 02:38:49 +00:00
Matthias Clasen
7baf68502f Add gprintfint.h and trio.
2002-12-15  Matthias Clasen  <maclas@gmx.de>

	* glib/Makefile.am (IGNORE_HFILES): Add gprintfint.h and trio.

	* glib/trio/glibtrio.h: New file, redefining all trio symbols to
	fall into the _G/_g_ private glib namespace.

	* glib/trio/Makefile.am (libtrio_la_SOURCES): Add glibtrio.h

	* glib/trio/trionan.c:
	* glib/trio/triostr.c:
	* glib/trio/trio.c: Include glibtrio.h

	* glib/gprintfint.h:
	* glib/trio/trionan.c:
	* glib/trio/triostr.c:
	* glib/trio/trio.c: Include glibtrio.h
2002-12-15 00:03:46 +00:00
Matthias Clasen
ab5fe79f8a Add --ignore-files=trio to avoid gtk-doc warnings about doxygen comments.
* glib/Makefile.am (MKDB_OPTIONS): Add --ignore-files=trio to
	avoid gtk-doc warnings about doxygen comments.
2002-12-12 23:34:37 +00:00
Owen Taylor
63524f96ee Improve docs for return value and @microseconds out parameter. (Reported
Tue Dec 10 11:55:28 2002  Owen Taylor  <otaylor@redhat.com>

        * glib/tmpl/timers.sgml: Improve docs for return value
        and @microseconds out parameter. (Reported by
        Dennis Haney, #100841)
2002-12-10 16:57:25 +00:00
Matthias Clasen
657428da90 Add docs.
* gobject/tmpl/generic_values.sgml:
	* gobject/tmpl/gtype.sgml:
	* gobject/tmpl/enumerations_flags.sgml: Add docs.
2002-12-09 23:26:17 +00:00
Matthias Clasen
20f6d1b814 Add docs.
* gobject/tmpl/gtype.sgml:
	* gobject/tmpl/enumerations_flags.sgml: Add docs.
2002-12-09 19:47:10 +00:00
Matthias Clasen
bec0034918 Add GTypeClass, GTypePluginClass and GTypeModuleClass.
* gobject/tmpl/gtype.sgml:
	* gobject/tmpl/gtypeplugin.sgml:
	* gobject/tmpl/gtypemodule.sgml:
	* gobject/gobject-sections.txt: Add GTypeClass, GTypePluginClass
	and GTypeModuleClass.

	* gobject/tmpl/gboxed.sgml: Add docs.
2002-12-09 19:06:42 +00:00
Matthias Clasen
b9da696ea0 Add docs.
* gobject/tmpl/enumerations_flags.sgml:
	* gobject/tmpl/gclosure.sgml:
	* gobject/tmpl/param_value_types.sgml: Add docs.
2002-12-08 23:16:50 +00:00
Matthias Clasen
9b275961ef Typo fix. 2002-12-06 01:47:27 +00:00
Matthias Clasen
4a2fac6031 Add Since and Deprecation info for symbols documented in the templates.
* glib/tmpl/strings.sgml:
	* glib/tmpl/scanner.sgml:
	* glib/tmpl/main.sgml:
	* glib/tmpl/macros_misc.sgml:
	* glib/tmpl/hash_tables.sgml: Add Since and Deprecation info
	for symbols documented in the templates.

	* glib/gstrfuncs.c (g_strncasecmp): Break long deprecation
	info into two paragraphs.
2002-12-05 22:32:20 +00:00
Matthias Clasen
6df677db74 Sync parameter names with docs and implementation.
* gsignal.h (g_signal_add_emission_hook):
	* gtype.h (g_type_interface_get_plugin): Sync parameter names with
	docs and implementation.

	* gtype.c (g_type_add_interface_dynamic):
	(g_type_interface_get_plugin):
	(g_type_interface_peek_parent):
	(g_type_query): Add docs.

	* gobject/tmpl/gtype.sgml: Add docs.

	* gobject/tmpl/signals.sgml: Regenerated.
2002-12-03 23:54:55 +00:00
Matthias Clasen
0b93fa4048 More GSignal docs. 2002-12-02 19:56:12 +00:00
Matthias Clasen
90d5b0fced More docs.
* gsignal.c: More docs.

	* gobject/gobject-sections.txt: Mark g_signal_handlers_destroy as
	private.

	* gobject/tmpl/signals.sgml: Move some docs inline.
2002-12-01 01:32:11 +00:00
Matthias Clasen
97489993f7 Adjust to changed parameter names.
* glib/gtimer.c (g_time_val_add): Adjust to changed parameter names.

	* glib/gutils.c (g_get_application_name): Mark as 2.2. addition.

	* glib/gstrfuncs.c (g_ascii_strtoull): Mark as 2.0.7 addition.

	* glib/tmpl/main.sgml: Write something about GSourceDummyMarshal.

	* glib/tmpl/date.sgml:
	* glib/tmpl/string_utils.sgml: Remove redundant docs.

	* glib/glib-sections.txt: Add g_ascii_strtoull and
	g_get_application_name.
2002-11-28 23:11:58 +00:00
Matthias Clasen
803bae66a3 Move some docs inline, and add deprecation information. To see the list of
* glib/gutils.c:
	* glib/gtree.c:
	* glib/gstring.c:
	* glib/gstrfuncs.c:
	* glib/giochannel.c: Move some docs inline, and add deprecation
	information. To see the list of affected functions, grep for
	"Deprecated:".

	* glib/tmpl/strings.sgml:
	* glib/tmpl/string_utils.sgml:
	* glib/tmpl/misc_utils.sgml: Move some docs inline.
2002-11-28 20:46:29 +00:00
Matthias Clasen
e80c828a42 Add missing short descriptions, standardize them to start with a capital
* gobject/tmpl/gclosure.sgml:
	* gobject/tmpl/signals.sgml:
	* gobject/tmpl/gparamspec.sgml:
	* gobject/tmpl/value_collection.sgml:
	* gobject/tmpl/generic_values.sgml:
	* gobject/tmpl/param_value_types.sgml:
	* gobject/tmpl/gboxed.sgml:
	* gobject/tmpl/enumerations_flags.sgml:
	* gobject/tmpl/objects.sgml:
	* gobject/tmpl/gtypemodule.sgml:
	* gobject/tmpl/gtypeplugin.sgml: Add missing short descriptions,
	standardize them to start with a capital and end without a period.

	* glib/tmpl/arrays.sgml:
	* glib/tmpl/memory_chunks.sgml:
	* glib/tmpl/macros.sgml: Remove periods from titles in examples.
2002-11-23 22:57:35 +00:00
Matthias Clasen
940d8a269d Explain --enable-include-printf.
* glib/building.sgml: Explain --enable-include-printf.
2002-11-23 21:37:54 +00:00
Matthias Clasen
105183376d Add version info to API docs. 2002-11-23 01:37:17 +00:00
Owen Taylor
eaf8e13856 Add helpful comments about the encoding of a new iochannel. (Amaury
Thu Nov 21 15:52:04 2002  Owen Taylor  <otaylor@redhat.com>

        * glib/tmpl/iochannels.sgml: Add helpful comments about
        the encoding of a new iochannel. (Amaury Jacquot,
        #96444)
2002-11-21 20:54:44 +00:00
Matthias Clasen
bc54ea6edf Include a printf implementation supporting C99 snprintf and SUS
positional parameters:  (#79488)

	* glib/gstrfuncs.c:
	* glib/gspawn-win32.c:
	* glib/gscanner.c:
	* glib/gconvert.c:
	* glib/gbacktrace.c: Use _g_printf wrappers.

	* glib/gutils.c (g_vsnprintf): Simplify, since we can assume C99
	snprintf semantics now.

	* glib/gmessages.c (printf_string_upper_bound): No longer needed,
	since we can assume C99 snprintf semantics now.
	(g_logv): Simplify.

	* acinclude.m4 (AC_FUNC_PRINTF_UNIX98): New macro to check wether
	printf supports SUS positional parameters.

	* configure.in: New option --enable-included-printf to force
	compilation of trio; otherwise trio is compiled if the system
	printf misses either C99 snprintf semantics of SUS positional
	parameters.

	* glib/Makefile.am (SUBDIRS): Conditionally compile trio.
	(libglib_2_0_la_SOURCES): Add gprintf.c and gprintfint.h.
	(glibsubinclude_HEADERS): Add gprintf.h.

	* glib/gprintfint.h: New private wrapping either system printf
	or trio printf variants in _g_printf wrappers for use inside glib.

	* glib/gprintf.h: New public header declaring g_printf variants.
	* glib/gprintf.c: Corresponding implementations.

	* glib/trio/*: New directory, containing the trio-1.9 sources.

	* glib/tmpl/string_utils.sgml: Add note on including gprintf.h,
	move some docs inline.

	* glib/glib-sections.txt: Add g_printf, g_vprintf, g_fprintf,
	g_vfprintf, g_sprintf, g_vsprintf.
2002-11-21 00:35:15 +00:00
Matthias Clasen
dc645ce354 Use G_LIKELY. (#69022)
* glib/gmessages.h (g_return_if_fail):
	(g_return_val_if_fail): Use G_LIKELY.  (#69022)

	* glib/gmacros.h (G_LIKELY):
	(G_UNLIKELY): New macros for hinting the compiler about the
	expected result of expressions. For gcc 3.x, define these
	using __builtin_expect.  (#69022)

	* glib/tmpl/macros_misc.sgml: Document G_LIKELY, G_UNLIKELY.

	* glib/glib-sections.txt: Add G_LIKELY, G_UNLIKELY.
2002-11-20 21:50:16 +00:00
Matthias Clasen
f74c33fc1d Update to latest gtk-doc version. 2002-10-19 23:41:27 +00:00
Matthias Clasen
1565a2027e Add g_type_interface_prerequisites. 2002-10-15 21:16:20 +00:00
Matthias Clasen
336d715c8e Dist the xml/*.xml, not sgml/*.sgml. (#95678, Owen Taylor)
* gobject/Makefile.am (dist-hook):
	* glib/Makefile.am (dist-hook): Dist the xml/*.xml, not
	sgml/*.sgml.  (#95678, Owen Taylor)
2002-10-14 21:54:11 +00:00
Matthias Clasen
c359153dfd Adapt to latest gtk-doc changes. 2002-10-14 00:14:27 +00:00
Matthias Clasen
8ca0f66ea7 Replace G_LOG_FLAG_RECURSIVE by G_LOG_FLAG_RECURSION throughout. (#93390)
* glib/tmpl/messages.sgml: Replace G_LOG_FLAG_RECURSIVE by
	G_LOG_FLAG_RECURSION throughout.  (#93390)
2002-09-16 20:55:59 +00:00
Matthias Clasen
71f016708a Add g_markup_parse_context_get_element and g_utf8_strreverse.
* glib/glib-sections.txt: Add g_markup_parse_context_get_element
	and g_utf8_strreverse.
2002-08-12 21:28:45 +00:00
Owen Taylor
0f6d709867 Fix reference to non-existing @priority parameter. (#88500, Linux Walleij)
Thu Jul 25 18:58:29 2002  Owen Taylor  <otaylor@redhat.com>

        * glib/tmpl/threads.sgml: Fix reference to non-existing
        @priority parameter. (#88500, Linux Walleij)
2002-07-25 22:59:54 +00:00
Matthias Clasen
a2e3f606ed Replace homegrown "hash" entity by standard ISO entity "num".
* glib/gwin32.c (g_win32_get_package_installation_directory):
	Replace homegrown "hash" entity by standard ISO entity "num".

	* gobject/gobject-docs.sgml:
	* glib/glib-docs.sgml:
	* glib/tmpl/macros.sgml:
	* glib/tmpl/string_utils.sgml: Replace homegrown "nbsp", "hash"
	and "percent" entities by standard ISO entities "nbsp", "num" and
	"percnt".
2002-06-03 17:34:37 +00:00
Matthias Clasen
bca67c15fe Small formatting fixes.
* glib/tmpl/string_utils.sgml:
	* glib/tmpl/threads.sgml: Small formatting fixes.
2002-05-30 21:55:14 +00:00
Matthias Clasen
5e45a337b8 Remove references to nonexisting functions
* glib/gmain.c: Remove references to nonexisting functions
	g_source_set_callback_closure(), g_source_poll(), g_source_add()
	from docs.

	* glib/gdir.c (g_dir_open): Typo fix in docs.

	* glib/gasyncqueue.c (g_async_queue_lock):
	(g_async_queue_unref_and_unlock): Fix markup to avoid erroneous
	<link>s in docs.

	* glib/gwin32.c: Escape #'s leading to erroneous <link>s in docs.

	* glib/gtree.c: Replace some occurances of Gtree by GTree in docs.

	* glib/gstring.c (g_string_insert_unichar): Typo fix in docs.

	* glib/tmpl/conversions.sgml: Add GIConv.

	* glib/tmpl/main.sgml: Fix references to nonexisting functions
	g_main_loop_destroy(), g_source_add(), g_source_connect().

	* glib/glib-sections.txt: Add GIConv, g_str_has_prefix, g_str_has_suffix.

	* glib/tmpl/linked_lists_single.sgml:
	* glib/tmpl/linked_lists_double.sgml: GListAllocator doesn't exist.

	* glib/glib-docs.sgml: Declare hash entity.

	* glib/tmpl/macros.sgml: Escape # in #ifdef to suppress erroneous links.

	* gobject/Makefile.am, gobject/gobject-docs.sgml, gobject/tmpl/*:
	* glib/Makefile.am, glib/glib-docs.sgml, glib/tmpl/*: Produce XML,
	not SGML.
2002-05-26 22:46:28 +00:00
Matthias Clasen
ea3db7ce06 Added proper support for CDATA sections. Updates.
* glib/gmarkup.c (g_markup_parse_context_parse): Added
	proper support for CDATA sections.
	* glib/tmpl/markup.sgml: Updates.
2002-05-20 22:59:11 +00:00
Tim Janik
7aebfd424f [merged from stable]
Sat May 18 00:44:35 2002  Tim Janik  <timj@gtk.org>

        [merged from stable]

        * glib/tmpl/scanner.sgml: fix documentation for g_scanner_unexp_token().
2002-05-17 22:49:06 +00:00