From 33acbf5b764ff8f6bbe74120d056e7d7bd3595c3 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Wed, 27 Dec 2006 05:10:54 +0000 Subject: [PATCH] Forgotten file --- glib/gunicollate.c | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) diff --git a/glib/gunicollate.c b/glib/gunicollate.c index 13a8ed5b8..494d0a449 100644 --- a/glib/gunicollate.c +++ b/glib/gunicollate.c @@ -54,11 +54,11 @@ msc_strxfrm_wrapper (char *string1, * @str2: a UTF-8 encoded string * * Compares two strings for ordering using the linguistically - * correct rules for the current locale. When sorting a large - * number of strings, it will be significantly faster to - * obtain collation keys with g_utf8_collate_key() and - * compare the keys with strcmp() when - * sorting instead of sorting the original strings. + * correct rules for the current locale. + * When sorting a large number of strings, it will be significantly + * faster to obtain collation keys with g_utf8_collate_key() and + * compare the keys with strcmp() when sorting instead of sorting + * the original strings. * * Return value: < 0 if @str1 compares before @str2, * 0 if they compare equal, > 0 if @str1 compares after @str2. @@ -184,9 +184,13 @@ utf8_encode (char *buf, wchar_t val) * Converts a string into a collation key that can be compared * with other collation keys produced by the same function using * strcmp(). + * * The results of comparing the collation keys of two strings - * with strcmp() will always be the same as - * comparing the two original keys with g_utf8_collate(). + * with strcmp() will always be the same as comparing the two + * original keys with g_utf8_collate(). + * + * Note that this function depends on the + * current locale. * * Return value: a newly allocated string. This string should * be freed with g_free() when you are done with it. @@ -302,6 +306,9 @@ g_utf8_collate_key (const gchar *str, * "event.h" instead of "event.c" "event.h" "eventgenerator.c". Also, we * would like to treat numbers intelligently so that "file1" "file10" "file5" * is sorted as "file1" "file5" "file10". + * + * Note that this function depends on the + * current locale. * * Return value: a newly allocated string. This string should * be freed with g_free() when you are done with it.