From 3c29bcea771f59846cfb3c8eb61f6ada6ff41e13 Mon Sep 17 00:00:00 2001
From: Markus Unterwaditzer <markus@unterwaditzer.net>
Date: Tue, 13 Jan 2015 23:39:10 +0100
Subject: [PATCH] Elaborate on advantages of virtualenv

---
 docs/problems.rst | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/docs/problems.rst b/docs/problems.rst
index 237ad1a..1e961c6 100644
--- a/docs/problems.rst
+++ b/docs/problems.rst
@@ -69,7 +69,12 @@ the simplest possible way would look something like::
     alias vdirsyncer="~/vdirsyncer_env/bin/vdirsyncer
 
 You'll have to put the last line into your ``.bashrc`` or ``.bash_profile``.
-The main advantage is that you can delete the ``~/vdirsyncer_env`` folder to
-uninstall vdirsyncer.
+
+This method has two advantages:
+
+- It separately installs all Python packages into ``~/vdirsyncer_env/``,
+  without relying on the system packages. This works around OS- or
+  distro-specific issues.
+- You can delete ``~/vdirsyncer_env/`` to uninstall vdirsyncer entirely.
 
 .. _virtualenv: https://virtualenv.readthedocs.org/