diff docs/setup.rst @ 7327:9937ae52f167

hg: set encoding to utf-8 by default to always show unicode characters correctly Unicode characters would be shown as '?' if Kallithea was launched in a LANG=C environment (or similar). The problem could be solved by setting HGENCODING before launching Kallithea or before importing Mercurial. These are often not good solutions. Instead, introduce a hgencoding config setting that triggers monkey patching of Mercurial.
author Mads Kiilerich <mads@kiilerich.com>
date Sat, 09 Jun 2018 16:28:33 +0200
parents d24051ce961c
children d5eaa70e0f2a
line wrap: on
line diff
--- a/docs/setup.rst	Sat May 19 22:00:41 2018 +0200
+++ b/docs/setup.rst	Sat Jun 09 16:28:33 2018 +0200
@@ -633,6 +633,9 @@
 library is installed. If ``chardet`` is detected Kallithea will fallback to it
 when there are encode/decode errors.
 
+The Mercurial encoding is configurable as ``hgencoding``. It is similar to
+setting the ``HGENCODING`` environment variable, but will override it.
+
 
 Celery configuration
 --------------------
@@ -894,7 +897,6 @@
 .. code-block:: python
 
     import os
-    os.environ["HGENCODING"] = "UTF-8"
     os.environ['PYTHON_EGG_CACHE'] = '/srv/kallithea/.egg-cache'
 
     # sometimes it's needed to set the current dir