Index: glib/gutf8.c
===================================================================
RCS file: /cvs/gnome/glib/glib/gutf8.c,v
retrieving revision 1.47
diff -u -p -r1.47 gutf8.c
--- glib/gutf8.c	17 Nov 2005 15:50:30 -0000	1.47
+++ glib/gutf8.c	17 Nov 2005 19:22:55 -0000
@@ -285,7 +285,9 @@ g_utf8_get_char (const gchar *p)
  * within the string.
  * 
  * Since 2.10, this function allows to pass a negative @offset to
- * step backwards.
+ * step backwards. It is usually worth stepping backward if @offset is
+ * in the last fourth of @str, since moving forward is about 3 times faster
+ * than moving backward.
  * 
  * Return value: the resulting pointer
  **/
