+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:
-<INCLUDE>gobject.h</INCLUDE>
+<INCLUDE>glib-object.h</INCLUDE>
<SECTION>
<FILE>gtype</FILE>
<SUBSECTION>
G_TYPE_GSTRING
+G_TYPE_STRV
+GStrv
<SUBSECTION Standard>
G_TYPE_IS_BOXED
<SECTION>
<TITLE>Varargs Value Collection</TITLE>
<FILE>value_collection</FILE>
+<INCLUDE>glib-object.h,gobject/gvaluecollector.h</INCLUDE>
GTypeCValue
G_VALUE_COLLECT
G_VALUE_LCOPY
<!-- ##### UNION GTypeCValue ##### -->
<para>
-
+A union holding one collected value.
</para>
<!-- ##### MACRO G_VALUE_COLLECT ##### -->
<para>
-
+Collects a variable argument value from a va_list. We have to
+implement the varargs collection as a macro, because on some systems
+va_list variables cannot be passed by reference.
</para>
-@value:
-@var_args:
-@flags:
-@__error:
+@value: a #GValue return location. @value is supposed to be initialized
+ according to the value type to be collected
+@var_args: the va_list variable; it may be evaluated multiple times
+@flags: flags which are passed on to the collect_value() function of
+ the #GTypeValueTable of @value.
+@__error: a #gchar** variable that will be modified to hold a g_new()
+ allocated error messages if something fails
<!-- ##### MACRO G_VALUE_LCOPY ##### -->
<para>
-
+Collects a value's variable argument locations from a va_list.
</para>
-@value:
-@var_args:
-@flags:
-@__error:
+@value: a #GValue return location. @value is supposed to be initialized
+ according to the value type to be collected
+@var_args: the va_list variable; it may be evaluated multiple times
+@flags: flags which are passed on to the lcopy_value() function of
+ the #GTypeValueTable of @value.
+@__error: a #gchar** variable that will be modified to hold a g_new()
+ allocated error messages if something fails
<!-- ##### MACRO G_VALUE_COLLECT_FORMAT_MAX_LENGTH ##### -->
<para>
-
+The maximal number of #GTypeCValue<!-- -->s which can be collected for a
+single #GValue.
</para>