[glib] gobject: Fix documentation for G_VALUE_LCOPY

[Philip Withnall <pwithnall src gnome org>]

commit 1af84aa4359f23731a3a9eb8e9d6d2df61730274
Author: Philip Withnall <withnall endlessm com>
Date:   Fri Apr 27 18:44:41 2018 +0100

    gobject: Fix documentation for G_VALUE_LCOPY
    
    It was previously a copy–paste of G_VALUE_COLLECT, which is wrong,
    because it’s the inverse function of G_VALUE_COLLECT. Document that, so
    the whole thing is a little less confusing (but by no means perfect).
    
    Signed-off-by: Philip Withnall <withnall endlessm com>
    Reviewed-by: nobody

 gobject/gvaluecollector.h | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)
---
diff --git a/gobject/gvaluecollector.h b/gobject/gvaluecollector.h
index f58858841..13b6f8f26 100644
--- a/gobject/gvaluecollector.h
+++ b/gobject/gvaluecollector.h
@@ -195,16 +195,16 @@ G_STMT_START {                                                                          
  \
 
 /**
  * G_VALUE_LCOPY:
- * @value: a #GValue return location. @value is supposed to be initialized 
- *  according to the value type to be collected
+ * @value: a #GValue to store into the @var_args; this must be initialized
+ *  and set
  * @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
- * 
- * Collects a value's variable argument locations from a va_list. Usage is
- * analogous to G_VALUE_COLLECT().
+ *
+ * Stores a value’s value into one or more argument locations from a va_list.
+ * This is the inverse of G_VALUE_COLLECT().
  */
 #define G_VALUE_LCOPY(value, var_args, flags, __error)                                 \
 G_STMT_START {                                                                         \