locale_description(4)
Name
locale_description - locale description
file
Synopsis
/usr/lib/locale/<localename>/locale_description
Description
The locale_description file is the source
of extended attributes and their values associated with the locale.
The lines in the file must have the following format:
key: value
Note that SPACE and/or TAB character(s), if any, at the start
and end of value are ignored. Empty lines and lines starting with
# are ignored.
The valid keys and corresponding values are:
|
|
language
|
The two-letter language code from ISO 639.
|
language-<language>
|
The language name in the native language represented by the
<language>, where <
language> is a two-letter language code from
ISO 639.
|
language-<language>_<
territory>
|
The language name in the native language represented by the <
language> and <territory>,
where <language> is
a two-letter language code from ISO 639 and <territory>
is an ISO 3166 two-letter territory code.
|
territory
|
The ISO 3166-1 territory code of the locale.
|
territory-<language>
|
The territory name in the native language represented by the <
language>, where <language>
is a two-letter language code from ISO 639.
|
territory-<language>_<
territory>
|
The territory name in the native language represented by the <
language> and <territory>,
where <language> is
a two-letter language code from ISO 639 and <territory>
is an ISO 3166 two-letter territory code.
|
codeset
|
The codeset of the locale.
|
codeset-<language>
|
The codeset name in the native language represented by the
<language> , where
<language> is a two-letter language code from ISO
639.
|
codeset-<language>_<
territory>
|
The codeset name in the native language represented by the <
language> and <territory>,
where <language> is
a two-letter language code from ISO 639 and <territory>
is an ISO 3166 two-letter territory code.
|
modifier
|
The modifier name for the locale.
|
modifier-<language>
|
The modifier name in the native language represented by the <
language> where, <language>
is a two-letter language code from ISO 639.
|
modifier-<language>_<
territory>
|
The modifier name in the native language represented by the <
language> and <territory>,
where <language> is
a two-letter language code from ISO 639 and <territory>
is an ISO 3166 two-letter territory code.
|
locale-<language>
|
The locale name in the native language by the <language
> where, <language> is
a two-letter language code from ISO 639.
|
locale-<language>_<
territory>
|
The locale name in the native language represented by the <
language> and <territory>,
where <language> is
a two-letter language code from ISO 639 and <territory>
is an ISO 3166 two-letter territory code.
|
timezone
|
The timezone valid for the locale. The key can be used multiple
times, the value is then a list of all the individual values for each
instance of the key.
|
legacy
|
The locale is legacy locale. The valid value is 'yes' or 'true'.
|
alias
|
The locale name alias. Only locale name aliases defined in locale_alias(5) are allowed. The key can be used multiple
times, the value is then a list of all the individual values for each
instance of the key.
|
|
The interpretation of invalid keys or values is not defined.
The locale_description file and all the entries
are optional.
If the locale follows the suggested naming convention, the values
of <language>, <territory>
and others are determined from the locale name. If the locale does
not follow the naming convention and the locale_description file
does not exist, the <language>, <
territory> and other values are unknown for the given
locale.
If the language-<language> is
not defined, but it is defined in other locale with the same language,
the value from the locale is used. The locale with the same territory
is preferred if multiple locales match. The same logic is applicable
for territory-<language>, codeset-<
language>, and modifier-<language>.
If timezone is not defined, but it is defined
in other locale with the same language and territory, the value from
the locale is used. If no definition is found, but timezone is defined
in other locale with the same territory, the value is used.
The text file codeset is UTF-8.
Examples
Example 1 locale_description File
for
en_GB.UTF-8 Locale
#
# /usr/lib/locale/en_GB.UTF-8/locale_description
#
language: en
territory: GB
codeset: UTF-8
alias: en_GB.utf8
alias: EN_GB
timezone: Europe/London
language-en: British English
language-fr: anglais britannique
# ...
territory-en: United Kingdom
territory-fr: Royaume-Uni
# ...
Attributes
See attributes(5) for descriptions of the following attributes:
|
|
Interface Stability
|
Committed
|
|
See Also
locale_alias(5), localedef(1)