From: Colin Walters <walters@verbum.org>
Date: Wed, 29 Feb 2012 17:37:24 +0000 (-0500)
Subject: g_uri_unescape_segment: Mention (allow-none)/%NULL in documentation
X-Git-Tag: 2.31.20~28
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=80611295ab56dd95add95a9600ba8bc88d5e9a62;p=platform%2Fupstream%2Fglib.git

g_uri_unescape_segment: Mention (allow-none)/%NULL in documentation
---

diff --git a/glib/gurifuncs.c b/glib/gurifuncs.c
index 25b098d..d438205 100644
--- a/glib/gurifuncs.c
+++ b/glib/gurifuncs.c
@@ -63,9 +63,9 @@ unescape_character (const char *scanner)
 
 /**
  * g_uri_unescape_segment:
- * @escaped_string: a string.
- * @escaped_string_end: a string.
- * @illegal_characters: an optional string of illegal characters not to be allowed.
+ * @escaped_string: (allow-none): A string, may be %NULL
+ * @escaped_string_end: (allow-none): Pointer to end of @escaped_string, may be %NULL
+ * @illegal_characters: (allow-none): An optional string of illegal characters not to be allowed, may be %NULL
  * 
  * Unescapes a segment of an escaped string.
  *
@@ -76,7 +76,9 @@ unescape_character (const char *scanner)
  * handling.
  *
  * Returns: an unescaped version of @escaped_string or %NULL on error.
- * The returned string should be freed when no longer needed.
+ * The returned string should be freed when no longer needed.  As a
+ * special case if %NULL is given for @escaped_string, this function
+ * will return %NULL.
  *
  * Since: 2.16
  **/