# `CONSFIGURATOR.PROPERTY.LOCALE`

## API reference

### General

#### Property: `LOCALE:AVAILABLE`

`(locale:available locale)`

Ensure that the locale LOCALE is generated and available.

Fails if a locale is not available to be generated. That is, a commented out entry for the locale and an accompanying charset must be present in /etc/locale.gen.

Per Debian bug #684134 we cannot ensure a locale is generated by means of APT:RECONFIGURE. So this property edits /etc/locale.gen manually.

#### Property: `LOCALE:SELECTED-FOR`

`(locale:selected-for locale &rest locale-variables)`

Select a locale for a list of global locale variables.

A locale variable is of the form LC_FOO, LANG or LANGUAGE. See locale(5). One might say

    (locale:selected-for "en_GB.UTF-8" "LC_PAPER" "LC_MONETARY")

to select the British English locale for paper size and currency conventions.

Note that reverting this property does not make a locale unavailable. That’s because it might be required for other applications of this property.