Add a documentation page for pyenv

2 files changed, 25 insertions, 0 deletions

diff --git a/doc/source/misc/index.rst b/doc/source/misc/index.rst
index 08349437..fe8f1100 100644
--- a/doc/source/misc/index.rst
+++ b/doc/source/misc/index.rst
@@ -9,6 +9,7 @@ Contents:
     carbons
     correct
     personal_events
+    pyenv
     separate
     ssl
     troubleshooting
diff --git a/doc/source/misc/pyenv.rst b/doc/source/misc/pyenv.rst
new file mode 100644
index 00000000..42f8c208
--- /dev/null
+++ b/doc/source/misc/pyenv.rst
@@ -0,0 +1,24 @@
+.. _pyenv-install:
+
+Pyenv - Installing python 3.4 as an user
+========================================
+
+Pyenv_ is a useful script that allows you to install several python versions
+in your user directory, and lets you manage which one you want depending on
+the directory you are in. It is therefore useful for people who are on
+distributions not providing the latest stable version, such as Debian or
+CentOS.
+
+You can follow the step-by-step `installation tutorial`_ on github that will
+help you install it to your home directory (on step 5, you should use 3.4.2
+which is the latest python 3.4 release at the time of writing this page); or
+you can use the `automated installer`_ and use ``pyenv install 3.4.2``
+thereafter.
+
+Then you only need to add a ``.python-version`` file containing ``3.4.2`` in
+your poezio directory to make the python version in that directory default to
+the python 3.4.2 installed with pyenv.
+
+.. _Pyenv: https://github.com/yyuu/pyenv
+.. _installation tutorial: https://github.com/yyuu/pyenv#installation
+.. _automated installer: https://github.com/yyuu/pyenv-installer