luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-03-26 09:30:04 +01:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'locale-docs' into 'master'

Browse Source 
gcharset: Expand the documentation for g_get_locale_variants()

See merge request GNOME/glib!1163
This commit is contained in:
Sebastian Dröge 2019-10-18 14:38:36 +00:00
commit f904587fcc
1 changed files with 8 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
glib/gcharset.c
View File

@ -549,10 +549,15 @@ append_locale_variants (GPtrArray *array,
* Returns a list of derived variants of @locale, which can be used to
* e.g. construct locale-dependent filenames or search paths. The returned
* list is sorted from most desirable to least desirable.
* This function handles territory, charset and extra locale modifiers.
* This function handles territory, charset and extra locale modifiers. See
* [`setlocale(3)`](man:setlocale) for information about locales and their format.
*
* For example, if @locale is "fr_BE", then the returned list
* is "fr_BE", "fr".
* @locale itself is guaranteed to be returned in the output.
*
* For example, if @locale is `fr_BE`, then the returned list
* is `fr_BE`, `fr`. If @locale is `en_GB.UTF-8@euro`, then the returned list
* is `en_GB.UTF-8@euro`, `en_GB.UTF-8`, `en_GB@euro`, `en_GB`, `en.UTF-8@euro`,
* `en.UTF-8`, `en@euro`, `en`.
*
* If you need the list of variants for the current locale,
* use g_get_language_names().