document value arrays.

Sun Aug 12 02:24:36 2001  Tim Janik  <timj@gtk.org>

        * gobject/tmpl/value_arrays.sgml: document value arrays.

docs/reference/ChangeLog

@@ -1,3 +1,7 @@
+Sun Aug 12 02:24:36 2001  Tim Janik  <timj@gtk.org>
+
+	* gobject/tmpl/value_arrays.sgml: document value arrays.
+
 2001-08-06  Sven Neumann  <sven@gimp.org>
 
 	* docs/reference/gobject/gobject-sections.txt

docs/reference/glib/tmpl/glib-unused.sgml

@@ -91,6 +91,12 @@ depending on the system type.
 </para>
 
 
+<!-- ##### MACRO G_IO_CHANNEL_DOS_LINE_TERM ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### MACRO G_IO_CHANNEL_ENCODE_RAW ##### -->
 <para>
 Encoding for nonbuffered IO. With this encoding, data must be
@@ -99,6 +105,18 @@ not work.
 </para>
 
 
+<!-- ##### MACRO G_IO_CHANNEL_MACINTOSH_LINE_TERM ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO G_IO_CHANNEL_UNIX_LINE_TERM ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### MACRO access ##### -->
 <para>
 

docs/reference/glib/tmpl/iochannels.sgml

@@ -77,23 +77,7 @@ A data structure representing an IO Channel. The fields should be considered
 private and should only be accessed with the following functions.
 </para>
 
-@ref_count: 
-@funcs: 
-@encoding: 
-@read_cd: 
-@write_cd: 
-@line_term: 
-@buf_size: 
-@read_buf: 
-@encoded_read_buf: 
-@write_buf: 
-@partial_write_buf: 
-@use_buffer: 
-@do_encode: 
 @close_on_unref: 
-@is_readable: 
-@is_writeable: 
-@is_seekable: 
 
 <!-- ##### FUNCTION g_io_channel_unix_new ##### -->
 <para>
@@ -150,6 +134,17 @@ programmer (unless you are creating a new type of #GIOChannel).
 @Returns: 
 
 
+<!-- ##### FUNCTION g_io_channel_read_unichar ##### -->
+<para>
+
+</para>
+
+@channel: 
+@thechar: 
+@error: 
+@Returns: 
+
+
 <!-- ##### FUNCTION g_io_channel_read_line ##### -->
 <para>
 
@@ -200,6 +195,17 @@ programmer (unless you are creating a new type of #GIOChannel).
 @Returns: 
 
 
+<!-- ##### FUNCTION g_io_channel_write_unichar ##### -->
+<para>
+
+</para>
+
+@channel: 
+@thechar: 
+@error: 
+@Returns: 
+
+
 <!-- ##### FUNCTION g_io_channel_flush ##### -->
 <para>
 
@@ -292,7 +298,6 @@ operation.
 @G_IO_CHANNEL_ERROR_NXIO: 
 @G_IO_CHANNEL_ERROR_OVERFLOW: 
 @G_IO_CHANNEL_ERROR_PIPE: 
-@G_IO_CHANNEL_ERROR_PCHAR_FLUSH: 
 @G_IO_CHANNEL_ERROR_FAILED: 
 
 <!-- ##### MACRO G_IO_CHANNEL_ERROR ##### -->
@@ -541,27 +546,6 @@ generic way.
 @line_term: 
 
 
-<!-- ##### MACRO G_IO_CHANNEL_UNIX_LINE_TERM ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO G_IO_CHANNEL_DOS_LINE_TERM ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO G_IO_CHANNEL_MACINTOSH_LINE_TERM ##### -->
-<para>
-
-</para>
-
-
-
 <!-- ##### FUNCTION g_io_channel_get_buffered ##### -->
 <para>
 

docs/reference/gobject/gobject-docs.sgml

@@ -12,6 +12,7 @@
 <!entity gobject-Varargs-Value-Collection SYSTEM "sgml/value_collection.sgml">
 <!entity gobject-Signals SYSTEM "sgml/signals.sgml">
 <!entity gobject-Closures SYSTEM "sgml/closures.sgml">
+<!entity gobject-Value-Arrays SYSTEM "sgml/value_arrays.sgml">
 ]>
 <book id="index">
   <bookinfo>
@@ -78,6 +79,7 @@
       &gobject-Standard-Parameter-Types;
       &gobject-Signals;
       &gobject-Closures;
+      &gobject-Value-Arrays;
       
   </reference>
   

docs/reference/gobject/gobject-sections.txt

@@ -40,10 +40,12 @@ G_TYPE_CHECK_VALUE
 G_TYPE_CHECK_VALUE_TYPE
 G_TYPE_FLAG_RESERVED_ID_BIT
 g_type_init
+g_type_init_with_debug_flags
 g_type_name
 g_type_qname
 g_type_from_name
 g_type_parent
+g_type_depth
 g_type_next_base
 g_type_is_a
 g_type_fundamental_branch_last
@@ -56,6 +58,7 @@ g_type_children
 g_type_interfaces
 g_type_set_qdata
 g_type_get_qdata
+g_type_query
 GBaseInitFunc
 GBaseFinalizeFunc
 GClassInitFunc
@@ -71,6 +74,7 @@ g_type_register_dynamic
 g_type_register_fundamental
 g_type_add_interface_static
 g_type_add_interface_dynamic
+g_type_interface_add_prerequisite
 g_type_get_plugin
 g_type_interface_get_plugin
 g_type_fundamental_last
@@ -154,7 +158,9 @@ G_OBJECT_CLASS_NAME
 G_VALUE_HOLDS_OBJECT
 g_object_class_install_property
 g_object_class_find_property
+g_object_class_list_properties
 g_object_new
+g_object_newv
 g_object_ref
 g_object_unref
 g_object_weak_ref
@@ -182,6 +188,7 @@ g_object_new_valist
 g_object_set_valist
 g_object_get_valist
 g_object_watch_closure
+g_object_run_dispose
 g_value_set_object
 g_value_get_object
 g_value_dup_object
@@ -269,6 +276,7 @@ GTypeValueTable
 <TITLE>Value arrays</TITLE>
 <FILE>value_arrays</FILE>
 GValueArray
+g_value_array_get_nth
 g_value_array_new
 g_value_array_copy
 g_value_array_free
@@ -391,12 +399,16 @@ G_IS_PARAM_SPEC_DOUBLE
 G_PARAM_SPEC_DOUBLE
 G_IS_PARAM_SPEC_STRING
 G_PARAM_SPEC_STRING
-G_IS_PARAM_SPEC_POINTER
-G_PARAM_SPEC_POINTER
-G_IS_PARAM_SPEC_BOXED
-G_PARAM_SPEC_BOXED
 G_IS_PARAM_SPEC_PARAM
 G_PARAM_SPEC_PARAM
+G_IS_PARAM_SPEC_BOXED
+G_PARAM_SPEC_BOXED
+G_IS_PARAM_SPEC_POINTER
+G_PARAM_SPEC_POINTER
+G_IS_PARAM_SPEC_VALUE_ARRAY
+G_PARAM_SPEC_VALUE_ARRAY
+G_IS_PARAM_SPEC_CLOSURE
+G_PARAM_SPEC_CLOSURE
 G_IS_PARAM_SPEC_OBJECT
 G_PARAM_SPEC_OBJECT
 GParamSpecChar
@@ -406,14 +418,17 @@ GParamSpecInt
 GParamSpecUInt
 GParamSpecLong
 GParamSpecULong
+GParamSpecUnichar
 GParamSpecEnum
 GParamSpecFlags
 GParamSpecFloat
 GParamSpecDouble
 GParamSpecString
-GParamSpecBoxed
 GParamSpecParam
+GParamSpecBoxed
 GParamSpecPointer
+GParamSpecValueArray
+GParamSpecClosure
 GParamSpecObject
 g_param_spec_char
 g_param_spec_uchar
@@ -422,15 +437,17 @@ g_param_spec_int
 g_param_spec_uint
 g_param_spec_long
 g_param_spec_ulong
+g_param_spec_unichar
 g_param_spec_enum
 g_param_spec_flags
 g_param_spec_float
 g_param_spec_double
 g_param_spec_string
-g_param_spec_string_c
-g_param_spec_boxed
 g_param_spec_param
+g_param_spec_boxed
 g_param_spec_pointer
+g_param_spec_value_array
+g_param_spec_closure
 g_param_spec_object
 </SECTION>
 
@@ -455,7 +472,7 @@ GSignalQuery
 G_SIGNAL_TYPE_STATIC_SCOPE
 G_SIGNAL_MATCH_MASK
 G_SIGNAL_FLAGS_MASK
-g_signal_newc
+g_signal_new
 g_signal_newv
 g_signal_new_valist
 g_signal_query
@@ -467,6 +484,9 @@ g_signal_emit_by_name
 g_signal_emitv
 g_signal_emit_valist
 g_signal_connect_data
+g_signal_connect
+g_signal_connect_after
+g_signal_connect_swapped
 g_signal_connect_object
 g_signal_connect_closure
 g_signal_connect_closure_by_id
@@ -477,8 +497,14 @@ g_signal_handler_find
 g_signal_handlers_block_matched
 g_signal_handlers_unblock_matched
 g_signal_handlers_disconnect_matched
+g_signal_handler_is_connected
+g_signal_handlers_block_by_func
+g_signal_handlers_unblock_by_func
+g_signal_handlers_disconnect_by_func
 g_signal_has_handler_pending
 g_signal_stop_emission
+g_signal_stop_emission_by_name
+g_signal_add_emission_hook
 g_signal_add_emission_hook_full
 g_signal_remove_emission_hook
 g_signal_parse_name
@@ -504,13 +530,14 @@ g_cclosure_new_object
 g_cclosure_new_object_swap
 g_closure_new_object
 g_closure_ref
+g_closure_sink
 g_closure_unref
 g_closure_invoke
 g_closure_invalidate
-g_closure_add_fnotify
+g_closure_add_finalize_notifier
-g_closure_remove_fnotify
+g_closure_add_invalidate_notifier
-g_closure_add_inotify
+g_closure_remove_finalize_notifier
-g_closure_remove_inotify
+g_closure_remove_invalidate_notifier
 g_closure_new_simple
 g_closure_set_marshal
 g_closure_add_marshal_guards

docs/reference/gobject/tmpl/closures.sgml

@@ -151,6 +151,14 @@ Closures
 @Returns: 
 
 
+<!-- ##### FUNCTION g_closure_sink ##### -->
+<para>
+
+</para>
+
+@closure: 
+
+
 <!-- ##### FUNCTION g_closure_unref ##### -->
 <para>
 
@@ -179,6 +187,46 @@ Closures
 @closure: 
 
 
+<!-- ##### FUNCTION g_closure_add_finalize_notifier ##### -->
+<para>
+
+</para>
+
+@closure: 
+@notify_data: 
+@notify_func: 
+
+
+<!-- ##### FUNCTION g_closure_add_invalidate_notifier ##### -->
+<para>
+
+</para>
+
+@closure: 
+@notify_data: 
+@notify_func: 
+
+
+<!-- ##### FUNCTION g_closure_remove_finalize_notifier ##### -->
+<para>
+
+</para>
+
+@closure: 
+@notify_data: 
+@notify_func: 
+
+
+<!-- ##### FUNCTION g_closure_remove_invalidate_notifier ##### -->
+<para>
+
+</para>
+
+@closure: 
+@notify_data: 
+@notify_func: 
+
+
 <!-- ##### FUNCTION g_closure_new_simple ##### -->
 <para>
 

docs/reference/gobject/tmpl/objects.sgml

@@ -177,6 +177,16 @@ The Base Object Type
 @Returns: 
 
 
+<!-- ##### FUNCTION g_object_class_list_properties ##### -->
+<para>
+
+</para>
+
+@oclass: 
+@n_properties: 
+@Returns: 
+
+
 <!-- ##### FUNCTION g_object_new ##### -->
 <para>
 
@@ -190,6 +200,17 @@ The Base Object Type
 @first_param_name: 
 
 
+<!-- ##### FUNCTION g_object_newv ##### -->
+<para>
+
+</para>
+
+@object_type: 
+@n_parameters: 
+@parameters: 
+@Returns: 
+
+
 <!-- ##### FUNCTION g_object_ref ##### -->
 <para>
 
@@ -470,6 +491,14 @@ to match the one used with g_object_add_weak_pointer().
 @closure: 
 
 
+<!-- ##### FUNCTION g_object_run_dispose ##### -->
+<para>
+
+</para>
+
+@object: 
+
+
 <!-- ##### FUNCTION g_value_set_object ##### -->
 <para>
 

docs/reference/gobject/tmpl/signals.sgml

@@ -207,6 +207,24 @@ filled in by the g_signal_query() function.
 
 
 
+<!-- ##### FUNCTION g_signal_new ##### -->
+<para>
+
+</para>
+
+@signal_name: 
+@itype: 
+@signal_flags: 
+@class_offset: 
+@accumulator: 
+@accu_data: 
+@c_marshaller: 
+@return_type: 
+@n_params: 
+@Varargs: 
+@Returns: 
+
+
 <!-- ##### FUNCTION g_signal_newv ##### -->
 <para>
 
@@ -349,6 +367,39 @@ g_signal_query().
 @after: 
 
 
+<!-- ##### MACRO g_signal_connect ##### -->
+<para>
+
+</para>
+
+@instance: 
+@detailed_signal: 
+@c_handler: 
+@data: 
+
+
+<!-- ##### MACRO g_signal_connect_after ##### -->
+<para>
+
+</para>
+
+@instance: 
+@detailed_signal: 
+@c_handler: 
+@data: 
+
+
+<!-- ##### MACRO g_signal_connect_swapped ##### -->
+<para>
+
+</para>
+
+@instance: 
+@detailed_signal: 
+@c_handler: 
+@data: 
+
+
 <!-- ##### FUNCTION g_signal_connect_object ##### -->
 <para>
 
@@ -534,6 +585,46 @@ otherwise.
 @Returns: 	The amount of handlers that got disconnected.
 
 
+<!-- ##### FUNCTION g_signal_handler_is_connected ##### -->
+<para>
+
+</para>
+
+@instance: 
+@handler_id: 
+@Returns: 
+
+
+<!-- ##### MACRO g_signal_handlers_block_by_func ##### -->
+<para>
+
+</para>
+
+@instance: 
+@func: 
+@data: 
+
+
+<!-- ##### MACRO g_signal_handlers_unblock_by_func ##### -->
+<para>
+
+</para>
+
+@instance: 
+@func: 
+@data: 
+
+
+<!-- ##### MACRO g_signal_handlers_disconnect_by_func ##### -->
+<para>
+
+</para>
+
+@instance: 
+@func: 
+@data: 
+
+
 <!-- ##### FUNCTION g_signal_has_handler_pending ##### -->
 <para>
 
@@ -556,6 +647,28 @@ otherwise.
 @detail: 
 
 
+<!-- ##### FUNCTION g_signal_stop_emission_by_name ##### -->
+<para>
+
+</para>
+
+@instance: 
+@detailed_signal: 
+
+
+<!-- ##### FUNCTION g_signal_add_emission_hook ##### -->
+<para>
+
+</para>
+
+@signal_id: 
+@quark: 
+@hook_func: 
+@hook_data: 
+@data_destroy: 
+@Returns: 
+
+
 <!-- ##### FUNCTION g_signal_remove_emission_hook ##### -->
 <para>
 

docs/reference/gobject/tmpl/standard_params.sgml

@@ -206,7 +206,7 @@ Standard Parameter Types
 @pspec: 
 
 
-<!-- ##### MACRO G_IS_PARAM_SPEC_POINTER ##### -->
+<!-- ##### MACRO G_IS_PARAM_SPEC_PARAM ##### -->
 <para>
 
 </para>
@@ -214,7 +214,7 @@ Standard Parameter Types
 @pspec: 
 
 
-<!-- ##### MACRO G_PARAM_SPEC_POINTER ##### -->
+<!-- ##### MACRO G_PARAM_SPEC_PARAM ##### -->
 <para>
 
 </para>
@@ -238,7 +238,7 @@ Standard Parameter Types
 @pspec: 
 
 
-<!-- ##### MACRO G_IS_PARAM_SPEC_PARAM ##### -->
+<!-- ##### MACRO G_IS_PARAM_SPEC_POINTER ##### -->
 <para>
 
 </para>
@@ -246,7 +246,39 @@ Standard Parameter Types
 @pspec: 
 
 
-<!-- ##### MACRO G_PARAM_SPEC_PARAM ##### -->
+<!-- ##### MACRO G_PARAM_SPEC_POINTER ##### -->
+<para>
+
+</para>
+
+@pspec: 
+
+
+<!-- ##### MACRO G_IS_PARAM_SPEC_VALUE_ARRAY ##### -->
+<para>
+
+</para>
+
+@pspec: 
+
+
+<!-- ##### MACRO G_PARAM_SPEC_VALUE_ARRAY ##### -->
+<para>
+
+</para>
+
+@pspec: 
+
+
+<!-- ##### MACRO G_IS_PARAM_SPEC_CLOSURE ##### -->
+<para>
+
+</para>
+
+@pspec: 
+
+
+<!-- ##### MACRO G_PARAM_SPEC_CLOSURE ##### -->
 <para>
 
 </para>
@@ -338,6 +370,14 @@ Standard Parameter Types
 @maximum: 
 @default_value: 
 
+<!-- ##### STRUCT GParamSpecUnichar ##### -->
+<para>
+
+</para>
+
+@parent_instance: 
+@default_value: 
+
 <!-- ##### STRUCT GParamSpecEnum ##### -->
 <para>
 
@@ -391,13 +431,6 @@ Standard Parameter Types
 @null_fold_if_empty: 
 @ensure_non_null: 
 
-<!-- ##### STRUCT GParamSpecBoxed ##### -->
-<para>
-
-</para>
-
-@parent_instance: 
-
 <!-- ##### STRUCT GParamSpecParam ##### -->
 <para>
 
@@ -405,6 +438,13 @@ Standard Parameter Types
 
 @parent_instance: 
 
+<!-- ##### STRUCT GParamSpecBoxed ##### -->
+<para>
+
+</para>
+
+@parent_instance: 
+
 <!-- ##### STRUCT GParamSpecPointer ##### -->
 <para>
 
@@ -412,6 +452,22 @@ Standard Parameter Types
 
 @parent_instance: 
 
+<!-- ##### STRUCT GParamSpecValueArray ##### -->
+<para>
+
+</para>
+
+@parent_instance: 
+@element_spec: 
+@fixed_n_elements: 
+
+<!-- ##### STRUCT GParamSpecClosure ##### -->
+<para>
+
+</para>
+
+@parent_instance: 
+
 <!-- ##### STRUCT GParamSpecObject ##### -->
 <para>
 
@@ -522,6 +578,19 @@ Standard Parameter Types
 @Returns: 
 
 
+<!-- ##### FUNCTION g_param_spec_unichar ##### -->
+<para>
+
+</para>
+
+@name: 
+@nick: 
+@blurb: 
+@default_value: 
+@flags: 
+@Returns: 
+
+
 <!-- ##### FUNCTION g_param_spec_enum ##### -->
 <para>
 
@@ -593,19 +662,6 @@ Standard Parameter Types
 @Returns: 
 
 
-<!-- ##### FUNCTION g_param_spec_boxed ##### -->
-<para>
-
-</para>
-
-@name: 
-@nick: 
-@blurb: 
-@boxed_type: 
-@flags: 
-@Returns: 
-
-
 <!-- ##### FUNCTION g_param_spec_param ##### -->
 <para>
 
@@ -619,6 +675,19 @@ Standard Parameter Types
 @Returns: 
 
 
+<!-- ##### FUNCTION g_param_spec_boxed ##### -->
+<para>
+
+</para>
+
+@name: 
+@nick: 
+@blurb: 
+@boxed_type: 
+@flags: 
+@Returns: 
+
+
 <!-- ##### FUNCTION g_param_spec_pointer ##### -->
 <para>
 
@@ -631,6 +700,31 @@ Standard Parameter Types
 @Returns: 
 
 
+<!-- ##### FUNCTION g_param_spec_value_array ##### -->
+<para>
+
+</para>
+
+@name: 
+@nick: 
+@blurb: 
+@element_spec: 
+@flags: 
+@Returns: 
+
+
+<!-- ##### FUNCTION g_param_spec_closure ##### -->
+<para>
+
+</para>
+
+@name: 
+@nick: 
+@blurb: 
+@flags: 
+@Returns: 
+
+
 <!-- ##### FUNCTION g_param_spec_object ##### -->
 <para>
 

docs/reference/gobject/tmpl/types.sgml

@@ -405,6 +405,14 @@ type implementations or the signal system).
 @debug_flags: Bitwise combination of #GTypeDebugFlags values for debugging purposes.
 
 
+<!-- ##### FUNCTION g_type_init_with_debug_flags ##### -->
+<para>
+
+</para>
+
+@debug_flags: 
+
+
 <!-- ##### FUNCTION g_type_name ##### -->
 <para>
 Return the unique name that is assigned to a type ID (this is the preferred method
@@ -444,6 +452,15 @@ If the passed in type has no parent, i.e. is a fundamental type, 0 is returned.
 @Returns: The parent type.
 
 
+<!-- ##### FUNCTION g_type_depth ##### -->
+<para>
+
+</para>
+
+@type: 
+@Returns: 
+
+
 <!-- ##### FUNCTION g_type_next_base ##### -->
 <para>
 Given a @leaf_type and a @root_type which is contained in its anchestry, return
@@ -585,6 +602,15 @@ g_free()ed after use.
 @Returns: 
 
 
+<!-- ##### FUNCTION g_type_query ##### -->
+<para>
+
+</para>
+
+@type: 
+@query: 
+
+
 <!-- ##### USER_FUNCTION GBaseInitFunc ##### -->
 <para>
 A callback function used by the type system to do base initialization
@@ -874,6 +900,15 @@ is used to manage the relationship.
 @plugin: 
 
 
+<!-- ##### FUNCTION g_type_interface_add_prerequisite ##### -->
+<para>
+
+</para>
+
+@interface_type: 
+@prerequisite_type: 
+
+
 <!-- ##### FUNCTION g_type_get_plugin ##### -->
 <para>
 Returns the the #GTypePlugin structure for @type or

docs/reference/gobject/tmpl/value_arrays.sgml

@@ -2,47 +2,61 @@
 Value arrays
 
 <!-- ##### SECTION Short_Description ##### -->
-
+A #GValueArray is a container structure to maintain an array of #GValue elements.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+The prime purpose of a #GValueArray is for it to be used as an object property
+that holds an array of values. A #GValueArray wraps an array of #GValue elements
+in order for it to be used as a boxed type through %G_TYPE_VALUE_ARRAY.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
 <para>
-
+#GValue, #GParamSpecValueArray
 </para>
 
 <!-- ##### STRUCT GValueArray ##### -->
 <para>
-
 </para>
 
-@n_values: 
+@n_values:     number of values contained in the array
-@values: 
+@values:       array of values
+
+<!-- ##### FUNCTION g_value_array_get_nth ##### -->
+<para>
+Return a pointer to the value at @index containd in @value_array.
+</para>
+
+@value_array: #GValueArray to get a value from
+@index:       index of the value of interest
+@Returns:     pointer to a value at @index in @value_array
+
 
 <!-- ##### FUNCTION g_value_array_new ##### -->
 <para>
-
+Allocate and initialize a new #GValueArray, optionally preserve space
+for @n_prealloced elements. New arrays always contain 0 elements,
+regardless of the value of @n_prealloced.
 </para>
 
-@n_prealloced: 
+@n_prealloced: number of values to preallocate space for
-@Returns: 
+@Returns:      a newly allocated #GValueArray with 0 values
 
 
 <!-- ##### FUNCTION g_value_array_copy ##### -->
 <para>
-
+Construct an exact copy of a #GValueArray by duplicating all its
+contents.
 </para>
 
-@value_array: 
+@value_array: #GValueArray to copy
-@Returns: 
+@Returns:     Newly allocated copy of #GValueArray
 
 
 <!-- ##### FUNCTION g_value_array_free ##### -->
 <para>
-
+Free a #GValueArray including its contents.
 </para>
 
 @value_array: 
@@ -50,63 +64,73 @@ Value arrays
 
 <!-- ##### FUNCTION g_value_array_append ##### -->
 <para>
-
+Insert a copy of @value as last element of @value_array.
 </para>
 
-@value_array: 
+@value_array: #GValueArray to add an element to
-@value: 
+@value:       #GValue to copy into #GValueArray
-@Returns: 
+@Returns:     the #GValueArray passed in as @value_array
 
 
 <!-- ##### FUNCTION g_value_array_prepend ##### -->
 <para>
-
+Insert a copy of @value as first element of @value_array.
 </para>
 
-@value_array: 
+@value_array: #GValueArray to add an element to
-@value: 
+@value:       #GValue to copy into #GValueArray
-@Returns: 
+@Returns:     the #GValueArray passed in as @value_array
 
 
 <!-- ##### FUNCTION g_value_array_insert ##### -->
 <para>
-
+Insert a copy of @value at specified position into @value_array.
 </para>
 
-@value_array: 
+@value_array: #GValueArray to add an element to
-@index: 
+@index:       insertion position, must be <= value_array->n_values
-@value: 
+@value:       #GValue to copy into #GValueArray
-@Returns: 
+@Returns:     the #GValueArray passed in as @value_array
 
 
 <!-- ##### FUNCTION g_value_array_remove ##### -->
 <para>
-
+Remove the value at position @index from @value_array.
 </para>
 
-@value_array: 
+@value_array: #GValueArray to remove an element from
-@index: 
+@index:       position of value to remove, must be < value_array->n_values
-@Returns: 
+@Returns:     the #GValueArray passed in as @value_array
 
 
 <!-- ##### FUNCTION g_value_array_sort ##### -->
 <para>
-
+Sort @value_array using @compare_func to compare the elements accoring to
+the semantics of #GCompareFunc.
 </para>
 
-@value_array: 
+<para>
-@compare_func: 
+The current implementation uses Quick-Sort as sorting algorithm.
-@Returns: 
+</para>
+
+@value_array:  #GValueArray to sort
+@compare_func: function to compare elements
+@Returns:      the #GValueArray passed in as @value_array
 
 
 <!-- ##### FUNCTION g_value_array_sort_with_data ##### -->
 <para>
-
+Sort @value_array using @compare_func to compare the elements accoring
+to the semantics of #GCompareDataFunc.
 </para>
 
-@value_array: 
+<para>
-@compare_func: 
+The current implementation uses Quick-Sort as sorting algorithm.
-@user_data: 
+</para>
-@Returns: 
+
+@value_array:   #GValueArray to sort
+@compare_func:  function to compare elements
+@user_data:     extra data argument provided for @compare_func
+@Returns:       the #GValueArray passed in as @value_array