summaryrefslogtreecommitdiff
path: root/glib/gutf8.c
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2008-01-28 03:15:23 +0000
committerMatthias Clasen <matthiasc@src.gnome.org>2008-01-28 03:15:23 +0000
commit137fdf9089bb448fb1a7ac86448268ead81573de (patch)
treee0cd0c1d60bc88b8002a22bd492f77bd07959790 /glib/gutf8.c
parent76e53c6ed3c63a71a49d21cb46e517a40f987d38 (diff)
downloadglib-137fdf9089bb448fb1a7ac86448268ead81573de.tar.gz
Document limitations of this function. (#487909, Peter Moulder)
2008-01-27 Matthias Clasen <mclasen@redhat.com> * glib/gutf8.c (g_utf8_strreverse): Document limitations of this function. (#487909, Peter Moulder) svn path=/trunk/; revision=6391
Diffstat (limited to 'glib/gutf8.c')
-rw-r--r--glib/gutf8.c6
1 files changed, 6 insertions, 0 deletions
diff --git a/glib/gutf8.c b/glib/gutf8.c
index c8f64019b..2676c4188 100644
--- a/glib/gutf8.c
+++ b/glib/gutf8.c
@@ -1773,6 +1773,12 @@ g_unichar_validate (gunichar ch)
* (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.