glib r6391 - in trunk: . glib

[matthiasc svn gnome org]

Author: matthiasc
Date: Mon Jan 28 03:15:23 2008
New Revision: 6391
URL: http://svn.gnome.org/viewvc/glib?rev=6391&view=rev

Log:
2008-01-27  Matthias Clasen  <mclasen redhat com>

        * glib/gutf8.c (g_utf8_strreverse): Document limitations
        of this function.  (#487909, Peter Moulder)




Modified:
   trunk/ChangeLog
   trunk/glib/gutf8.c

Modified: trunk/glib/gutf8.c
==============================================================================
--- trunk/glib/gutf8.c	(original)
+++ trunk/glib/gutf8.c	Mon Jan 28 03:15:23 2008
@@ -1773,6 +1773,12 @@
  * (Use g_utf8_validate() on all text before trying to use UTF-8 
  * utility functions with it.)
  *
+ * This function is intended for programmatic uses of reversed strings.
+ * It pays no attention to decomposed characters, combining marks, byte 
+ * order marks, directional indicators (LRM, LRO, etc) and similar 
+ * characters which might need special handling when reversing a string 
+ * for display purposes.
+ *
  * Note that unlike g_strreverse(), this function returns
  * newly-allocated memory, which should be freed with g_free() when
  * no longer needed.