From: Mathias Hasselmann <hasselmm@src.gnome.org>
Date: Thu, 6 Dec 2007 10:22:13 +0000 (+0000)
Subject: Mention g_utf8_normalize() returns NULL on invalid string. (#501997)
X-Git-Tag: GLIB_2_15_1~195
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=c79ef3793ca9b26ee1cc4a5a4e2bec1e8c8ae839;p=platform%2Fupstream%2Fglib.git

Mention g_utf8_normalize() returns NULL on invalid string. (#501997)

* glib/gunidecomp.c: Mention g_utf8_normalize()
returns NULL on invalid string. (#501997)

svn path=/trunk/; revision=6058
---

diff --git a/ChangeLog b/ChangeLog
index 50f154ad0..bbc82f2aa 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2007-12-06  Mathias Hasselmann  <mathias@openismus.com>
+
+	* glib/gunidecomp.c: Mention g_utf8_normalize()
+	returns NULL on invalid string. (#501997)
+
 2007-12-06  Mathias Hasselmann  <mathias@openismus.com>
 
 	* glib/gerror.c: Improve wording for g_propagate_error docs.
diff --git a/glib/gunidecomp.c b/glib/gunidecomp.c
index 27624d3f4..e6e9fa565 100644
--- a/glib/gunidecomp.c
+++ b/glib/gunidecomp.c
@@ -486,13 +486,14 @@ _g_utf8_normalize_wc (const gchar    *str,
  * @str: a UTF-8 encoded string.
  * @len: length of @str, in bytes, or -1 if @str is nul-terminated.
  * @mode: the type of normalization to perform.
- * 
+ *
  * Converts a string into canonical form, standardizing
  * such issues as whether a character with an accent
  * is represented as a base character and combining
- * accent or as a single precomposed character. You
- * should generally call g_utf8_normalize() before
- * comparing two Unicode strings.
+ * accent or as a single precomposed character. The
+ * string has to be valid UTF-8, otherwise %NULL is
+ * returned. You should generally call g_utf8_normalize()
+ * before comparing two Unicode strings.
  *
  * The normalization mode %G_NORMALIZE_DEFAULT only
  * standardizes differences that do not affect the
@@ -513,9 +514,10 @@ _g_utf8_normalize_wc (const gchar    *str,
  * useful if you intend to convert the string to
  * a legacy encoding or pass it to a system with
  * less capable Unicode handling.
- * 
- * Return value: a newly allocated string, that is the 
- *   normalized form of @str.
+ *
+ * Return value: a newly allocated string, that is the
+ *   normalized form of @str, or %NULL if @str is not
+ *   valid UTF-8.
  **/
 gchar *
 g_utf8_normalize (const gchar    *str,