``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

.. code-block:: none

  (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.