From: Colin Walters <walters@verbum.org>
Date: Fri, 27 May 2011 20:10:21 +0000 (-0400)
Subject: g_variant_new_dict_entry: Fix documentation and annotations
X-Git-Tag: 2.29.6~84
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=dfcac7b23e7cfbefc02f2d8772970340d7dd7fb5;p=platform%2Fupstream%2Fglib.git

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.
---

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.