[pypy-commit] pypy.org extradoc: tweak and fix for issue #2424

[mattip]

Author: Matti Picus <matti.picus at gmail.com>
Branch: extradoc
Changeset: r811:2d8cc7009dbd
Date: 2016-10-22 22:30 +0300
http://bitbucket.org/pypy/pypy.org/changeset/2d8cc7009dbd/

Log:	tweak and fix for issue #2424

diff --git a/download.html b/download.html
--- a/download.html
+++ b/download.html
@@ -205,9 +205,13 @@
 </div>
 <div class="section" id="installing-more-modules">
 <h1>Installing more modules</h1>
-<p>The recommended way is to install <tt class="docutils literal">pip</tt>, which is the standard package
+<p>There are as yet few distribution-ready packages.
+We recommend installing <tt class="docutils literal">pip</tt>, which is the standard package
 manager of Python.  It works like it does on CPython as explained in the
 <a class="reference external" href="http://doc.pypy.org/en/latest/install.html">installation documentation</a>.</p>
+<p>If you use your distribution's PyPy package we recommend you install packages
+into a virtualenv. If you try to build a module and the build process complains
+about “missing Python.h”, you may need to install the pypy-dev package.</p>
 </div>
 <div class="section" id="installing-numpy">
 <h1>Installing NumPy</h1>
diff --git a/source/download.txt b/source/download.txt
--- a/source/download.txt
+++ b/source/download.txt
@@ -216,13 +216,19 @@
 Installing more modules
 -------------------------------
 
-The recommended way is to install ``pip``, which is the standard package
+There are as yet few distribution-ready packages.
+We recommend installing ``pip``, which is the standard package
 manager of Python.  It works like it does on CPython as explained in the
-`installation documentation`_.
+`installation documentation`_. 
+
+If you use your distribution's PyPy package we recommend you install packages
+into a virtualenv. If you try to build a module and the build process complains
+about "missing Python.h", you may need to install the pypy-dev package.
 
 .. _installation documentation: http://doc.pypy.org/en/latest/install.html
 
 
+
 Installing NumPy
 -------------------------------