Locale environment

------------------

The locale configuration is also a part of the environment. On Unix,

environment variables like LANG or LC_ALL can specify a language and encoding

to use for code points outside the ASCII range. The flexibility of supporting

multiple encodings of Unicode has the flip site of having to specify which

encoding to use - especially for Mercurial.

It varies which settings are available. For example, some Docker containers

with Debian default to only support the `C` language, while other Linux

environments have `en_US` but not `C`. The `locale -a` command will show which

values are supported.

For technical reasons, this configuration *must* be provided in the environment

- it cannot be specified in the `.ini` file. Desktop sessions usually set the

environment variables to use some language (like `en_US`) and encoding (like

`UTF-8`). Services like Kallithea often run in a sanitized environment that is

using the default language `C` and the ASCII encoding. The locale must thus be

specified explicitly for the service.

        python-home=/srv/kallithea/venv lang=C.UTF-8

    WSGIDaemonProcess kallithea processes=5 threads=1 maximum-requests=100 lang=en_US.utf8