Documentation fixes: (#75255, Martin Schulze; #76104, Daryll Strauss)

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)

ChangeLog

@@ -1,3 +1,9 @@
+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

ChangeLog.pre-2-10

@@ -1,3 +1,9 @@
+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

ChangeLog.pre-2-12

@@ -1,3 +1,9 @@
+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

ChangeLog.pre-2-2

@@ -1,3 +1,9 @@
+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

ChangeLog.pre-2-4

@@ -1,3 +1,9 @@
+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

ChangeLog.pre-2-6

@@ -1,3 +1,9 @@
+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

ChangeLog.pre-2-8

@@ -1,3 +1,9 @@
+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

docs/reference/glib/tmpl/datalist.sgml

@@ -7,15 +7,16 @@ lists of data elements which are accessible by a string or #GQuark identifier.
 <!-- ##### 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
+Data lists are used for associating arbitrary data with
-#GtkObjects, using gtk_object_set_data() and related functions.
+#GObjects, using g_object_set_data() and related functions.
 </para>
 
 <para>
@@ -72,7 +73,8 @@ destroy function is called.
 
 @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 ##### -->
@@ -85,15 +87,17 @@ destroy function is called.
 
 @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.
@@ -127,7 +131,8 @@ Sets the data element corresponding to the given string identifier.
 
 @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 ##### -->
@@ -138,10 +143,11 @@ function to be called when the data element is removed.
 
 @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 ##### -->

docs/reference/glib/tmpl/main.sgml

@@ -626,6 +626,13 @@ an event source.
 </para>
 
 
+<!-- ##### USER_FUNCTION GSourceDummyMarshal ##### -->
+<para>
+
+</para>
+
+
+
 <!-- ##### STRUCT GSourceFuncs ##### -->
 <para>
 The #GSourceFuncs struct contains a table of functions used to handle
@@ -719,13 +726,6 @@ functions for managing callback objects.
 @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>
 

docs/reference/glib/tmpl/markup.sgml

@@ -181,6 +181,15 @@ passthrough text back out in the same position
 @char_number: 
 
 
+<!-- ##### FUNCTION g_markup_parse_context_get_element ##### -->
+<para>
+
+</para>
+
+@context: 
+@Returns: 
+
+
 <!-- ##### FUNCTION g_markup_parse_context_new ##### -->
 <para>
 

docs/reference/glib/tmpl/unicode.sgml

@@ -463,6 +463,16 @@ that may contain invalid UTF-8.
 @ch: 
 
 
+<!-- ##### FUNCTION g_utf8_strreverse ##### -->
+<para>
+
+</para>
+
+@str: 
+@len: 
+@Returns: 
+
+
 <!-- ##### FUNCTION g_utf8_validate ##### -->
 <para>
 

docs/reference/gobject/tmpl/gtypeplugin.sgml

@@ -53,8 +53,8 @@ GTypePlugin
 </para>
 
 @plugin: 
-@interface_type: 
 @instance_type: 
+@interface_type: 
 @info: 
 
 
@@ -91,8 +91,8 @@ GTypePlugin
 </para>
 
 @plugin: 
-@interface_type: 
 @instance_type: 
+@interface_type: 
 @info: 
 
 

glib/gmain.c

@@ -1111,7 +1111,15 @@ static GSourceCallbackFuncs g_source_callback_funcs = {
  * @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,