From d9fb0e4a427970f639c0e922f288cb2aac7dc8fe Mon Sep 17 00:00:00 2001 From: Behdad Esfahbod Date: Sun, 24 Dec 2006 04:15:40 +0000 Subject: Improve docs. 2006-12-23 Behdad Esfahbod * pango/pango-utils.c (pango_language_get_default): Improve docs. --- pango/pango-utils.c | 22 +++++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) (limited to 'pango/pango-utils.c') diff --git a/pango/pango-utils.c b/pango/pango-utils.c index cb1a5e58..5b59e33c 100644 --- a/pango/pango-utils.c +++ b/pango/pango-utils.c @@ -1142,9 +1142,29 @@ _pango_get_lc_ctype (void) * Returns the #PangoLanguage for the current locale of the process. * Note that this can change over the life of an application. * + * On Unix systems, this is the return value is derived from + * setlocale(LC_CTYPE, NULL), and the user can + * affect this through the environment variables LC_ALL, LC_CTYPE or + * LANG (checked in that order). The locale string typically is in + * the form lang_COUNTRY, where lang is an ISO-639 language code, and + * COUNTRY is an ISO-3166 country code. For instance, sv_FI for + * Swedish as written in Finland or pt_BR for Portuguese as written in + * Brazil. + * + * On Windows, the C library does not use any such environment + * variables, and setting them won't affect the behaviour of functions + * like ctime(). The user sets the locale through the Regional Options + * in the Control Panel. The C library (in the setlocale() function) + * does not use country and language codes, but country and language + * names spelled out in English. + * However, this function does check the above environment + * variables, and does return a Unix-style locale string based on + * either said environment variables or the thread's current locale. + * * Your application should call setlocale (LC_ALL, ""); * for the user settings to take effect. Gtk+ does this in its initialization - * functions. See man setlocale for details. + * functions automatically (by calling gtk_set_locale()). + * See man setlocale for more details. * * Return value: the default language as a #PangoLanguage, must not be * freed. -- cgit v1.2.1