Add a note explaining how to convert UTF-16 byte stream of ambiguous

Mon Sep 20 00:35:14 2004  Matthias Clasen  <maclas@gmx.de>

	* glib/gutf8.c (g_utf16_to_utf8): Add a note explaining how to
	convert UTF-16 byte stream of ambiguous endianness.  (#152954,
	Linus Walleij)

ChangeLog

@@ -1,3 +1,9 @@
+Mon Sep 20 00:35:14 2004  Matthias Clasen  <maclas@gmx.de>
+
+	* glib/gutf8.c (g_utf16_to_utf8): Add a note explaining how to
+	convert UTF-16 byte stream of ambiguous endianness.  (#152954,
+	Linus Walleij)
+
 Mon Sep 20 00:17:37 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* tests/option-test.c (error_test3_post_parse): 

ChangeLog.pre-2-10

@@ -1,3 +1,9 @@
+Mon Sep 20 00:35:14 2004  Matthias Clasen  <maclas@gmx.de>
+
+	* glib/gutf8.c (g_utf16_to_utf8): Add a note explaining how to
+	convert UTF-16 byte stream of ambiguous endianness.  (#152954,
+	Linus Walleij)
+
 Mon Sep 20 00:17:37 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* tests/option-test.c (error_test3_post_parse): 

ChangeLog.pre-2-12

@@ -1,3 +1,9 @@
+Mon Sep 20 00:35:14 2004  Matthias Clasen  <maclas@gmx.de>
+
+	* glib/gutf8.c (g_utf16_to_utf8): Add a note explaining how to
+	convert UTF-16 byte stream of ambiguous endianness.  (#152954,
+	Linus Walleij)
+
 Mon Sep 20 00:17:37 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* tests/option-test.c (error_test3_post_parse): 

ChangeLog.pre-2-6

@@ -1,3 +1,9 @@
+Mon Sep 20 00:35:14 2004  Matthias Clasen  <maclas@gmx.de>
+
+	* glib/gutf8.c (g_utf16_to_utf8): Add a note explaining how to
+	convert UTF-16 byte stream of ambiguous endianness.  (#152954,
+	Linus Walleij)
+
 Mon Sep 20 00:17:37 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* tests/option-test.c (error_test3_post_parse): 

ChangeLog.pre-2-8

@@ -1,3 +1,9 @@
+Mon Sep 20 00:35:14 2004  Matthias Clasen  <maclas@gmx.de>
+
+	* glib/gutf8.c (g_utf16_to_utf8): Add a note explaining how to
+	convert UTF-16 byte stream of ambiguous endianness.  (#152954,
+	Linus Walleij)
+
 Mon Sep 20 00:17:37 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* tests/option-test.c (error_test3_post_parse): 

glib/gutf8.c

@@ -1031,6 +1031,11 @@ g_ucs4_to_utf8 (const gunichar *str,
  * Convert a string from UTF-16 to UTF-8. The result will be
  * terminated with a 0 byte.
  *
+ * Note that the input is expected to be already in native endianness,
+ * an initial byte-order-mark character is not handled specially.
+ * g_convert() can be used to convert a byte buffer of UTF-16 data of 
+ * ambiguous endianess.
+ * 
  * Return value: a pointer to a newly allocated UTF-8 string.
  *               This value must be freed with g_free(). If an
  *               error occurs, %NULL will be returned and