Go to main content

man pages section 5: File Formats

Exit Print View

Updated: Thursday, June 13, 2019
 
 

locale_description(5)

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:

Key
Value
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(7) 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(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed

See Also

localedef(1), locale_alias(7), nlsadm(8)