# HG changeset patch
# User Armin Rigo <arigo@tunes.org>
# Date 1423670435 -3600
#      Wed Feb 11 17:00:35 2015 +0100
# Branch extradoc
# Node ID 0ef10b1892275e7ed708559cdf2f7492c06cc450
# Parent  7935f316ec1282680e1b27ec452ea497ae231eef
Complete the NumPy 2-paragraph instructions and link more clearly to
numpy/pypy.

diff --git a/download.html b/download.html
--- a/download.html
+++ b/download.html
@@ -213,10 +213,9 @@
 <p>NumPy is an exception to the rule that most packages work without
 changes.  The &ldquo;numpy&rdquo; module needs to be installed from <a class="reference external" href="https://bitbucket.org/pypy/numpy">our own
 repository</a> rather than from the official source.</p>
-<p>If you have pip (the command-line assumes that it finds the pip
-belonging to PyPy, not the one from CPython):</p>
+<p>If you have pip:</p>
 <pre class="literal-block">
-pip install git+https://bitbucket.org/pypy/numpy.git
+pypy -m pip install git+https://bitbucket.org/pypy/numpy.git
 </pre>
 <p>Alternatively, the direct way:</p>
 <pre class="literal-block">
@@ -224,8 +223,13 @@
 cd numpy
 pypy setup.py install
 </pre>
+<p>If you installed to a system directory, you need to also run this once:</p>
+<pre class="literal-block">
+sudo pypy -c 'import numpy'
+</pre>
 <p>Note that NumPy support is still a work-in-progress, many things do not
-work and those that do may not be any faster than NumPy on CPython.</p>
+work and those that do may not be any faster than NumPy on CPython.
+For further instructions see <a class="reference external" href="https://bitbucket.org/pypy/numpy">the pypy/numpy repository</a>.</p>
 </div>
 <div class="section" id="building-from-source">
 <span id="translate"></span><h1>Building from source</h1>
diff --git a/source/download.txt b/source/download.txt
--- a/source/download.txt
+++ b/source/download.txt
@@ -202,10 +202,9 @@
 
 .. __: https://bitbucket.org/pypy/numpy
 
-If you have pip (the command-line assumes that it finds the pip
-belonging to PyPy, not the one from CPython)::
+If you have pip::
 
-    pip install git+https://bitbucket.org/pypy/numpy.git
+    pypy -m pip install git+https://bitbucket.org/pypy/numpy.git
 
 Alternatively, the direct way::
 
@@ -213,8 +212,16 @@
     cd numpy
     pypy setup.py install
 
+If you installed to a system directory, you need to also run this once::
+
+    sudo pypy -c 'import numpy'
+
 Note that NumPy support is still a work-in-progress, many things do not
 work and those that do may not be any faster than NumPy on CPython.
+For further instructions see `the pypy/numpy repository`__.
+
+.. __: https://bitbucket.org/pypy/numpy
+
 
 .. _translate: