+2002-09-01 Soeren Sandmann <sandmann@daimi.au.dk>
+
+ * docs/reference/glib/tmpl/datalist.sgml, glib/gmain.c:
+
+ Documentation fixes: (#75255, Martin Schulze; #76104, Daryll Strauss)
+
2002-08-26 Tor Lillqvist <tml@iki.fi>
* configure.in (G_LIBS_EXTRA): Don't link with -lwsock32 on
+2002-09-01 Soeren Sandmann <sandmann@daimi.au.dk>
+
+ * docs/reference/glib/tmpl/datalist.sgml, glib/gmain.c:
+
+ Documentation fixes: (#75255, Martin Schulze; #76104, Daryll Strauss)
+
2002-08-26 Tor Lillqvist <tml@iki.fi>
* configure.in (G_LIBS_EXTRA): Don't link with -lwsock32 on
+2002-09-01 Soeren Sandmann <sandmann@daimi.au.dk>
+
+ * docs/reference/glib/tmpl/datalist.sgml, glib/gmain.c:
+
+ Documentation fixes: (#75255, Martin Schulze; #76104, Daryll Strauss)
+
2002-08-26 Tor Lillqvist <tml@iki.fi>
* configure.in (G_LIBS_EXTRA): Don't link with -lwsock32 on
+2002-09-01 Soeren Sandmann <sandmann@daimi.au.dk>
+
+ * docs/reference/glib/tmpl/datalist.sgml, glib/gmain.c:
+
+ Documentation fixes: (#75255, Martin Schulze; #76104, Daryll Strauss)
+
2002-08-26 Tor Lillqvist <tml@iki.fi>
* configure.in (G_LIBS_EXTRA): Don't link with -lwsock32 on
+2002-09-01 Soeren Sandmann <sandmann@daimi.au.dk>
+
+ * docs/reference/glib/tmpl/datalist.sgml, glib/gmain.c:
+
+ Documentation fixes: (#75255, Martin Schulze; #76104, Daryll Strauss)
+
2002-08-26 Tor Lillqvist <tml@iki.fi>
* configure.in (G_LIBS_EXTRA): Don't link with -lwsock32 on
+2002-09-01 Soeren Sandmann <sandmann@daimi.au.dk>
+
+ * docs/reference/glib/tmpl/datalist.sgml, glib/gmain.c:
+
+ Documentation fixes: (#75255, Martin Schulze; #76104, Daryll Strauss)
+
2002-08-26 Tor Lillqvist <tml@iki.fi>
* configure.in (G_LIBS_EXTRA): Don't link with -lwsock32 on
+2002-09-01 Soeren Sandmann <sandmann@daimi.au.dk>
+
+ * docs/reference/glib/tmpl/datalist.sgml, glib/gmain.c:
+
+ Documentation fixes: (#75255, Martin Schulze; #76104, Daryll Strauss)
+
2002-08-26 Tor Lillqvist <tml@iki.fi>
* configure.in (G_LIBS_EXTRA): Don't link with -lwsock32 on
<!-- ##### SECTION Long_Description ##### -->
<para>
Keyed data lists provide lists of arbitrary data elements which can be accessed
-either with a string or with a #GQuark corresponding to the string.
+either with a string or with a #GQuark corresponding to the
+string.
</para>
<para>
The #GQuark methods are quicker, since the strings have to be converted to
#GQuarks anyway.
</para>
<para>
-Data lists are used in GTK+ for associating arbitrary data with
-#GtkObjects, using gtk_object_set_data() and related functions.
+Data lists are used for associating arbitrary data with
+#GObjects, using g_object_set_data() and related functions.
</para>
<para>
@dl: a datalist.
@q: the #GQuark to identify the data element.
-@d: the data element.
+@d: the data element, or %NULL to remove any previous element
+corresponding to @q.
<!-- ##### FUNCTION g_datalist_id_set_data_full ##### -->
@datalist: a datalist.
@key_id: the #GQuark to identify the data element.
-@data: the data element.
+@data: the data element or %NULL to remove any previous element
+corresponding to @key_id.
@destroy_func: the function to call when the data element is removed. This
function will be called with the data element and can be used to free any
-memory allocated for it.
+memory allocated for it. If @data is %NULL, then @destroy_func must
+also be %NULL.
<!-- ##### FUNCTION g_datalist_id_get_data ##### -->
<para>
-Gets a data element.
+Retrieves the data element corresponding to @key_id.
</para>
@datalist: a datalist.
@dl: a datalist.
@k: the string to identify the data element.
-@d: the data element.
+@d: the data element, or %NULL to remove any previous element
+corresponding to @k.
<!-- ##### MACRO g_datalist_set_data_full ##### -->
@dl: a datalist.
@k: the string to identify the data element.
-@d: the data element.
+@d: the data element, or %NULL to remove any previous element corresponding to
+@k.
@f: the function to call when the data element is removed. This
function will be called with the data element and can be used to free any
-memory allocated for it.
+memory allocated for it. If @d is %NULL, then @f must also be %NULL.
<!-- ##### MACRO g_datalist_get_data ##### -->
</para>
+<!-- ##### USER_FUNCTION GSourceDummyMarshal ##### -->
+<para>
+
+</para>
+
+
+
<!-- ##### STRUCT GSourceFuncs ##### -->
<para>
The #GSourceFuncs struct contains a table of functions used to handle
@unref: Called when a reference to the callback object is dropped.
@get: Called to extract the callback function and data from the callback object.
-<!-- ##### USER_FUNCTION GSourceDummyMarshal ##### -->
-<para>
-
-</para>
-
-
-
<!-- ##### FUNCTION g_source_new ##### -->
<para>
@char_number:
+<!-- ##### FUNCTION g_markup_parse_context_get_element ##### -->
+<para>
+
+</para>
+
+@context:
+@Returns:
+
+
<!-- ##### FUNCTION g_markup_parse_context_new ##### -->
<para>
@ch:
+<!-- ##### FUNCTION g_utf8_strreverse ##### -->
+<para>
+
+</para>
+
+@str:
+@len:
+@Returns:
+
+
<!-- ##### FUNCTION g_utf8_validate ##### -->
<para>
</para>
@plugin:
-@interface_type:
@instance_type:
+@interface_type:
@info:
</para>
@plugin:
-@interface_type:
@instance_type:
+@interface_type:
@info:
* @data: the data to pass to callback function
* @notify: a function to call when @data is no longer in use, or %NULL.
*
- * Sets the callback function for a source.
+ * Sets the callback function for a source. The callback for a source is
+ * called from the source's dispatch function.
+ *
+ * The exact type of @func depends on the type of source; ie. you
+ * should not count on @func being called with @data as its first
+ * parameter.
+ *
+ * Typically, you won't use this function. Instead use functions specific
+ * to the type of source you are using.
**/
void
g_source_set_callback (GSource *source,