Simplify pip install (fixes #2958)

doc/README

@@ -13,19 +13,15 @@ You need to install :
   * Python Sphinx
     - Where apt-get is available :
           apt-get install python-sphinx
-    - On Windows :
+    - On Windows (or from inside your virtualenv) :
           Get pip (https://pypi.python.org/pypi/pip). You'll use it to install the dependencies.
-          To install pip, do python setup.py install in the pip directory.
+          To install pip, run python setup.py install in the pip directory.
-          Now do :
+          Now run :
-          pip install sphinx
+          pip install sphinxcontrib-blockdiag sphinxcontrib-seqdiag
-          pip install blockdiag
+          pip install sphinxcontrib-actdiag sphinxcontrib-nwdiag
-          pip install sphinxcontrib-blockdiag
+
-          pip install seqdiag
+          Or just use the provided doc-requirements.txt :
-          pip install sphinxcontrib-seqdiag
+          pip install -r doc-requirements.txt
-          pip install actdiag
-          pip install sphinxcontrib-actdiag
-          pip install nwdiag
-          pip install sphinxcontrib-nwdiag
 
   * Latest kivy
 

doc/doc-requirements.txt

@@ -0,0 +1,5 @@
+# Frozen Sphinx requirements for easier pip installation
+sphinxcontrib-actdiag
+sphinxcontrib-blockdiag
+sphinxcontrib-nwdiag
+sphinxcontrib-seqdiag