Commit Graph

346 Commits

Author SHA1 Message Date
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
Owen Taylor
2f4c3d8a6d Add g_markup_printf_escaped(), g_markup_vprintf_escaped().
Thu Sep 11 20:11:05 2003  Owen Taylor  <otaylor@redhat.com>

        * glib/gmarkup.c: Add g_markup_printf_escaped(),
        g_markup_vprintf_escaped().

        * tests/markup-escape-test.c (main): Test for
        g_markup_escape_text(), g_markup_printf_escaped().
2003-09-12 00:17:02 +00:00
Tim Janik
558507bc5a added support for a "default vtable" per interface, that interface vtables
Tue Sep  2 19:37:21 2003  Tim Janik  <timj@gtk.org>

        * gtype.[hc]: added support for a "default vtable" per interface,
        that interface vtables are initialized from.
        the default vtable is initialized and finalized through class_init,
        class_finalize and class_data from the interfaces GTypeInfo struct.
        (type_data_last_unref_Wm): unload child plugin before unreffing
        parent type.

        testifaceinit.c: minor fixups. fixed up base_init() assertions, since
        with a default vtable, base_init() may be called multiple times.
        added default initializer to iface1.
2003-09-02 17:57:22 +00:00
Owen Taylor
5e88cedf02 Clarify docs on the return. Fix a memory leak if a type with a value table
Mon Aug 25 14:16:48 2003  Owen Taylor  <otaylor@redhat.com>

        * gtypemodule.c (g_type_module_register_type): Clarify
        docs on the return. Fix a memory leak if a type with a
        value table is reloaded.
2003-08-25 18:23:58 +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
Noah Levitt
82911ba375 Revert accidental commit. (Oops.) 2003-07-30 22:31:23 +00:00
Noah Levitt
4dc25b3ac1 548d0e9ce9516c80c8f5830090bfcae3 2003-07-30 22:21:33 +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
e4f08fe7eb Commit autogenerated stuff. 2003-07-28 20:20:00 +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
ddf64dc40f Document the members of GOnce. 2003-07-09 00:08:39 +00:00
Matthias Clasen
7b52034de1 SGML fix. 2003-07-08 23:59:13 +00:00
Matthias Clasen
876f907863 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:48 +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
1858c03571 Broken pipe... 2003-07-01 22:15:54 +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
99c0940b78 Use the current g_file_get_contents() as example. 2003-06-04 22:49:08 +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
7e3b6db32d Forgotten cleanup. 2003-04-18 00:18:06 +00:00