[glib] gstring: Explictly annotate return-values with (transfer none/full)

[Rico Tzschichholz <ricotz src gnome org>]

commit 927a4ed2f435cc7561b489807706f5f6da0fba23
Author: Rico Tzschichholz <ricotz ubuntu com>
Date:   Tue Feb 2 11:13:08 2016 +0100

    gstring: Explictly annotate return-values with (transfer none/full)
    
    https://bugzilla.gnome.org/show_bug.cgi?id=744570

 glib/gstring.c |   48 ++++++++++++++++++++++++------------------------
 1 files changed, 24 insertions(+), 24 deletions(-)
---
diff --git a/glib/gstring.c b/glib/gstring.c
index e0f3ba1..9ba7b0a 100644
--- a/glib/gstring.c
+++ b/glib/gstring.c
@@ -240,7 +240,7 @@ g_string_free (GString  *string,
  * #GBytes does not include this extra nul; i.e. it has length exactly
  * equal to the "len" member.
  *
- * Returns: A newly allocated #GBytes containing contents of @string; @string itself is freed
+ * Returns: (transfer full): A newly allocated #GBytes containing contents of @string; @string itself is 
freed
  * Since: 2.34
  */
 GBytes*
@@ -330,7 +330,7 @@ g_string_hash (const GString *str)
  * the standard strcpy() function, except that you do not
  * have to worry about having enough space to copy the string.
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  */
 GString *
 g_string_assign (GString     *string,
@@ -359,7 +359,7 @@ g_string_assign (GString     *string,
  *
  * Cuts off the end of the GString, leaving the first @len bytes.
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  */
 GString *
 g_string_truncate (GString *string,
@@ -384,7 +384,7 @@ g_string_truncate (GString *string,
  * of the newly added area are undefined. (However, as
  * always, string->str[string->len] will be a nul byte.)
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  */
 GString *
 g_string_set_size (GString *string,
@@ -418,7 +418,7 @@ g_string_set_size (GString *string,
  * the caller's responsibility to ensure that @val has at
  * least @len addressable bytes.
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  */
 GString *
 g_string_insert_len (GString     *string,
@@ -534,7 +534,7 @@ gunichar_ok (gunichar c)
  * Appends @unescaped to @string, escaped any characters that
  * are reserved in URIs using URI-style escape sequences.
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  *
  * Since: 2.16
  */
@@ -587,7 +587,7 @@ g_string_append_uri_escaped (GString     *string,
  * Adds a string onto the end of a #GString, expanding
  * it if necessary.
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  */
 GString *
 g_string_append (GString     *string,
@@ -610,7 +610,7 @@ g_string_append (GString     *string,
  * the caller's responsibility to ensure that @val has at
  * least @len addressable bytes.
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  */
 GString *
 g_string_append_len (GString     *string,
@@ -628,7 +628,7 @@ g_string_append_len (GString     *string,
  * Adds a byte onto the end of a #GString, expanding
  * it if necessary.
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  */
 #undef g_string_append_c
 GString *
@@ -648,7 +648,7 @@ g_string_append_c (GString *string,
  * Converts a Unicode character into UTF-8, and appends it
  * to the string.
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  */
 GString *
 g_string_append_unichar (GString  *string,
@@ -667,7 +667,7 @@ g_string_append_unichar (GString  *string,
  * Adds a string on to the start of a #GString,
  * expanding it if necessary.
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  */
 GString *
 g_string_prepend (GString     *string,
@@ -690,7 +690,7 @@ g_string_prepend (GString     *string,
  * it is the caller's responsibility to ensure that
  * @val has at least @len addressable bytes.
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  */
 GString *
 g_string_prepend_len (GString     *string,
@@ -708,7 +708,7 @@ g_string_prepend_len (GString     *string,
  * Adds a byte onto the start of a #GString,
  * expanding it if necessary.
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  */
 GString *
 g_string_prepend_c (GString *string,
@@ -727,7 +727,7 @@ g_string_prepend_c (GString *string,
  * Converts a Unicode character into UTF-8, and prepends it
  * to the string.
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  */
 GString *
 g_string_prepend_unichar (GString  *string,
@@ -747,7 +747,7 @@ g_string_prepend_unichar (GString  *string,
  * Inserts a copy of a string into a #GString,
  * expanding it if necessary.
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  */
 GString *
 g_string_insert (GString     *string,
@@ -765,7 +765,7 @@ g_string_insert (GString     *string,
  *
  * Inserts a byte into a #GString, expanding it if necessary.
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  */
 GString *
 g_string_insert_c (GString *string,
@@ -804,7 +804,7 @@ g_string_insert_c (GString *string,
  * Converts a Unicode character into UTF-8, and insert it
  * into the string at the given position.
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  */
 GString *
 g_string_insert_unichar (GString  *string,
@@ -885,7 +885,7 @@ g_string_insert_unichar (GString  *string,
  *
  * Overwrites part of a string, lengthening it if necessary.
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  *
  * Since: 2.14
  */
@@ -908,7 +908,7 @@ g_string_overwrite (GString     *string,
  * Overwrites part of a string, lengthening it if necessary.
  * This function will work with embedded nuls.
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  *
  * Since: 2.14
  */
@@ -957,7 +957,7 @@ g_string_overwrite_len (GString     *string,
  * Removes @len bytes from a #GString, starting at position @pos.
  * The rest of the #GString is shifted down to fill the gap.
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  */
 GString *
 g_string_erase (GString *string,
@@ -991,7 +991,7 @@ g_string_erase (GString *string,
  *
  * Converts all uppercase ASCII letters to lowercase ASCII letters.
  *
- * Returns: passed-in @string pointer, with all the
+ * Returns: (transfer none): passed-in @string pointer, with all the
  *     uppercase characters converted to lowercase in place,
  *     with semantics that exactly match g_ascii_tolower().
  */
@@ -1022,7 +1022,7 @@ g_string_ascii_down (GString *string)
  *
  * Converts all lowercase ASCII letters to uppercase ASCII letters.
  *
- * Returns: passed-in @string pointer, with all the
+ * Returns: (transfer none): passed-in @string pointer, with all the
  *     lowercase characters converted to uppercase in place,
  *     with semantics that exactly match g_ascii_toupper().
  */
@@ -1053,7 +1053,7 @@ g_string_ascii_up (GString *string)
  *
  * Converts a #GString to lowercase.
  *
- * Returns: the #GString
+ * Returns: (transfer none): the #GString
  *
  * Deprecated:2.2: This function uses the locale-specific
  *     tolower() function, which is almost never the right thing.
@@ -1087,7 +1087,7 @@ g_string_down (GString *string)
  *
  * Converts a #GString to uppercase.
  *
- * Returns: @string
+ * Returns: (transfer none): @string
  *
  * Deprecated:2.2: This function uses the locale-specific
  *     toupper() function, which is almost never the right thing.