[glib] g_variant_new_dict_entry: Fix documentation and annotations



commit dfcac7b23e7cfbefc02f2d8772970340d7dd7fb5
Author: Colin Walters <walters verbum org>
Date:   Fri May 27 16:10:21 2011 -0400

    g_variant_new_dict_entry: Fix documentation and annotations
    
    Move @key to not be at the start of a line, otherwise g-ir-scanner
    gets confused.
    
    Also two annotation fixes.

 glib/gvariant.c |   10 ++++------
 1 files changed, 4 insertions(+), 6 deletions(-)
---
diff --git a/glib/gvariant.c b/glib/gvariant.c
index 3978733..bbe9d52 100644
--- a/glib/gvariant.c
+++ b/glib/gvariant.c
@@ -860,15 +860,13 @@ g_variant_make_dict_entry_type (GVariant *key,
 }
 
 /**
- * g_variant_new_dict_entry:
+ * g_variant_new_dict_entry: (constructor)
  * @key: a basic #GVariant, the key
  * @value: a #GVariant, the value
  * @returns: (transfer none): a floating reference to a new dictionary entry #GVariant
  *
- * Creates a new dictionary entry #GVariant.  @key and @value must be
- * non-%NULL.
- *
- * @key must be a value of a basic type (ie: not a container).
+ * Creates a new dictionary entry #GVariant. @key and @value must be
+ * non-%NULL. @key must be a value of a basic type (ie: not a container).
  *
  * If the @key or @value are floating references (see g_variant_ref_sink()),
  * the new instance takes ownership of them as if via g_variant_ref_sink().
@@ -1523,7 +1521,7 @@ g_variant_get_bytestring (GVariant *value)
  * @value: an array-of-bytes #GVariant instance
  * @length: (out) (allow-none) (default NULL): a pointer to a #gsize, to store
  *          the length (not including the nul terminator)
- * @returns: (transfer full) (array null-terminated=1): a newly allocated string
+ * @returns: (transfer full) (array zero-terminated=1): a newly allocated string
  *
  * Similar to g_variant_get_bytestring() except that instead of
  * returning a constant string, the string is duplicated.



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]