diff --git a/glib/gcharset.c b/glib/gcharset.c
index 9d25db584..704ea13c8 100644
--- a/glib/gcharset.c
+++ b/glib/gcharset.c
@@ -166,6 +166,10 @@ charset_cache_free (gpointer data)
  * handle file names. It might be different from the character set
  * used by the C library's current locale.
  *
+ * On Linux, the character set is found by consulting nl_langinfo() if
+ * available. If not, the environment variables `LC_ALL`, `LC_CTYPE`, `LANG`
+ * and `CHARSET` are queried in order.
+ *
  * The return value is %TRUE if the locale's encoding is UTF-8, in that
  * case you can perhaps avoid calling g_convert().
  *