Merge branch '0.24.x' of github.com:cython/cython into 0.24.x

docs/src/quickstart/install.rst

@@ -39,19 +39,23 @@ directory, and then run::
 
   python setup.py install
 
-If you have Python setuptools set up on your system, you should be
-able to fetch Cython from PyPI and install it using::
+If you have ``pip`` set up on your system (e.g. in a virtualenv or a
+recent Python version), you should be able to fetch Cython from PyPI
+and install it using
 
-  easy_install cython
+::
+
+  pip install Cython
 
-or
+For one-time builds, e.g. for CI/testing, on platforms that are not covered
+by one of the wheel packages provided on PyPI, it is substantially faster
+than a full source build to install an uncompiled (slower) version of Cython
+with
 
 ::
 
-  pip install cython
+    pip install Cython --install-option="--no-cython-compile"
 
-For Windows there is also an executable installer available for
-download.
 
 .. [Anaconda] http://docs.continuum.io/anaconda/
 .. [Canopy] https://enthought.com/products/canopy/

setup.py

@@ -296,6 +296,12 @@ setup(
     C/C++ libraries, and for fast C modules that speed up the execution of
     Python code.
 
+    Note that for one-time builds, e.g. for CI/testing, on platforms that are not
+    covered by one of the wheel packages provided on PyPI, it is substantially faster
+    than a full source build to install an uncompiled (slower) version of Cython with::
+
+        pip install Cython --install-option="--no-cython-compile"
+
     .. _Pyrex: http://www.cosc.canterbury.ac.nz/greg.ewing/python/Pyrex/
     """),
     license='Apache',