From 9aaac16d17903bad3adc9252d443dcb81a63015d Mon Sep 17 00:00:00 2001 From: Martin Zimmermann Date: Fri, 26 Sep 2014 16:48:47 +0200 Subject: [PATCH] add #125 and #129 to troubleshooting --- docs/docs/install.rst | 2 ++ docs/docs/troubleshooting.rst | 16 +++++++++++++++- 2 files changed, 17 insertions(+), 1 deletion(-) diff --git a/docs/docs/install.rst b/docs/docs/install.rst index c0b4518..fb5415a 100644 --- a/docs/docs/install.rst +++ b/docs/docs/install.rst @@ -10,6 +10,8 @@ next section carefully. :local: :depth: 1 + .. _install-interludium: + Interludium: Python is not PHP ------------------------------ diff --git a/docs/docs/troubleshooting.rst b/docs/docs/troubleshooting.rst index 56d1a8a..21514da 100644 --- a/docs/docs/troubleshooting.rst +++ b/docs/docs/troubleshooting.rst @@ -1,4 +1,18 @@ Troubleshooting =============== -To be written. +pkg_ressources.DistributionNotFound +----------------------------------- + +This is usually caused by messing up the system's Python with newer packages +from PyPi (e.g. by executing `easy_install --upgrade pip` as root) and is not +related to Isso at all. + +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. + +The web console shows 404 Not Found responses +--------------------------------------------- + +That's fine. Isso returns "404 Not Found" to indicate "No comments".