[glib] gconvert: add note to avoid transliteration

[Ryan Lortie <desrt src gnome org>]

commit 061793a726df038fb8c790984c81020e14feb0bb
Author: Ryan Lortie <desrt desrt ca>
Date:   Thu Feb 20 18:49:37 2014 -0500

    gconvert: add note to avoid transliteration
    
    Add a note to the documentation of g_convert() advising to avoid using
    it for transliteration.  Link to g_str_to_ascii().

 glib/gconvert.c |    3 +++
 1 files changed, 3 insertions(+), 0 deletions(-)
---
diff --git a/glib/gconvert.c b/glib/gconvert.c
index 8831bd6..2be1cbb 100644
--- a/glib/gconvert.c
+++ b/glib/gconvert.c
@@ -526,6 +526,9 @@ g_convert_with_iconv (const gchar *str,
  * character until it knows that the next character is not a mark that
  * could combine with the base character.)
  *
+ * Using extensions such as "//TRANSLIT" may not work (or may not work
+ * well) on many platforms.  Consider using g_str_to_ascii() instead.
+ *
  * Returns: If the conversion was successful, a newly allocated
  *               nul-terminated string, which must be freed with
  *               g_free(). Otherwise %NULL and @error will be set.