From fdc1c28a5ea92a03835b8145a660bb9a368ab5e2 Mon Sep 17 00:00:00 2001 From: Tor Lillqvist Date: Tue, 13 Jun 2006 22:46:52 +0000 Subject: [PATCH] Add Windows notes to doc comment. 2006-06-14 Tor Lillqvist * glib/gutils.c (g_listenv): Add Windows notes to doc comment. --- ChangeLog | 4 ++++ ChangeLog.pre-2-12 | 4 ++++ glib/gutils.c | 7 +++++++ 3 files changed, 15 insertions(+) diff --git a/ChangeLog b/ChangeLog index 3411734..4475597 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +2006-06-14 Tor Lillqvist + + * glib/gutils.c (g_listenv): Add Windows notes to doc comment. + 2006-06-12 Emmanuele Bassi * glib/gbookmarkfile.h: diff --git a/ChangeLog.pre-2-12 b/ChangeLog.pre-2-12 index 3411734..4475597 100644 --- a/ChangeLog.pre-2-12 +++ b/ChangeLog.pre-2-12 @@ -1,3 +1,7 @@ +2006-06-14 Tor Lillqvist + + * glib/gutils.c (g_listenv): Add Windows notes to doc comment. + 2006-06-12 Emmanuele Bassi * glib/gbookmarkfile.h: diff --git a/glib/gutils.c b/glib/gutils.c index b448260..7924857 100644 --- a/glib/gutils.c +++ b/glib/gutils.c @@ -1399,6 +1399,13 @@ g_unsetenv (const gchar *variable) * Returns: a %NULL-terminated list of strings which must be freed * with g_strfreev(). * + * Programs that want to be portable to Windows should typically use + * this function and g_getenv() instead of using the environ array + * from the C library directly. On Windows, the strings in the environ + * array are in system codepage encoding, while in most of the typical + * use cases for environment variables in GLib-using programs you want + * the UTF-8 encoding that this function and g_getenv() provide. + * * Since: 2.8 */ gchar ** -- 2.7.4