From a1be81f6c894cfd3a60a44861d79e6e414e3773b Mon Sep 17 00:00:00 2001 From: Martin Zimmermann Date: Sun, 16 Nov 2014 14:25:48 +0100 Subject: [PATCH] add UnicodeDecodeError to troubleshooting (via #93) --- docs/docs/troubleshooting.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/docs/troubleshooting.rst b/docs/docs/troubleshooting.rst index 21514da..20ee8dd 100644 --- a/docs/docs/troubleshooting.rst +++ b/docs/docs/troubleshooting.rst @@ -12,6 +12,21 @@ Install Isso in a virtual environment as described in :ref:`install-interludium`. Alternatively, you can use `pip install --user` to install Isso into the user's home. +UnicodeDecodeError: 'ascii' codec can't decode byte 0xff +-------------------------------------------------------- + +Likely an issue with your environment, check you set your preferred file +encoding either in :envvar:`LANG`, :envvar:`LANGUAGE`, :envvar:`LC_ALL` or +:envvar:`LC_CTYPE`: + +.. code-block:: text + + $ env LANG=C.UTF-8 isso [-h] [--version] ... + +If none of the mentioned variables is set, the interaction with Isso will +likely fail (unable to print non-ascii characters to stdout/err, unable to +parse configuration file with non-ascii characters and to forth). + The web console shows 404 Not Found responses ---------------------------------------------