[pypy-commit] pypy.org extradoc: Update to mention installing other modules (and NumPy) in the download page

[arigo]

Author: Armin Rigo <arigo at tunes.org>
Branch: extradoc
Changeset: r477:8537665bac0e
Date: 2014-03-14 18:42 +0100
http://bitbucket.org/pypy/pypy.org/changeset/8537665bac0e/

Log:	Update to mention installing other modules (and NumPy) in the
	download page

diff --git a/download.html b/download.html
--- a/download.html
+++ b/download.html
@@ -61,6 +61,8 @@
 </ul>
 </li>
 <li><a class="reference internal" href="#installing">Installing</a> (optional)</li>
+<li><a class="reference internal" href="#installing-more-modules">Installing more modules</a></li>
+<li><a class="reference internal" href="#installing-numpy">Installing NumPy</a> (optional)</li>
 <li><a class="reference internal" href="#building-from-source">Building from source</a></li>
 <li><a class="reference internal" href="#packaging">Packaging</a></li>
 <li><a class="reference internal" href="#checksums">Checksums</a></li>
@@ -160,6 +162,32 @@
 not move or copy the executable <tt class="docutils literal">pypy</tt> outside the tree – put
 a symlink to it, otherwise it will not find its libraries.</p>
 </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
+manager of Python.  It works like it does on CPython.  One practical
+difference, though, is that it usually comes pre-packaged for you when
+you get CPython from a place like your Linux distribution.  In the case
+of PyPy (or CPython if you download it from <a class="reference external" href="http://www.python.org/">http://www.python.org/</a>),
+you need to get it separately, as explained <a class="reference external" href="http://pypy.readthedocs.org/en/latest/faq.html#module-xyz-does-not-work-with-pypy-importerror">in our FAQ.</a></p>
+</div>
+<div class="section" id="installing-numpy">
+<h1>Installing NumPy</h1>
+<p>NumPy is an exception to the rule that most packages work without
+changes.  The “numpy” 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>
+<pre class="literal-block">
+pip install git+https://bitbucket.org/pypy/numpy.git
+</pre>
+<p>Alternatively, the direct way:</p>
+<pre class="literal-block">
+git clone https://bitbucket.org/pypy/numpy.git
+cd numpy
+pypy setup.py install
+</pre>
+</div>
 <div class="section" id="building-from-source">
 <span id="translate"></span><h1>Building from source</h1>
 <ol class="arabic">
diff --git a/source/download.txt b/source/download.txt
--- a/source/download.txt
+++ b/source/download.txt
@@ -32,6 +32,8 @@
    * `Other versions`_
 
  * `Installing`_ (optional)
+ * `Installing more modules`_
+ * `Installing NumPy`_ (optional)
  * `Building from source`_                       
  * `Packaging`_
  * `Checksums`_
@@ -182,6 +184,40 @@
 a symlink to it, otherwise it will not find its libraries.
 
 
+Installing more modules
+-------------------------------
+
+The recommended way is to install ``pip``, which is the standard package
+manager of Python.  It works like it does on CPython.  One practical
+difference, though, is that it usually comes pre-packaged for you when
+you get CPython from a place like your Linux distribution.  In the case
+of PyPy (or CPython if you download it from http://www.python.org/),
+you need to get it separately, as explained `in our FAQ.`__
+
+.. __: http://pypy.readthedocs.org/en/latest/faq.html#module-xyz-does-not-work-with-pypy-importerror
+
+
+Installing NumPy
+-------------------------------
+
+NumPy is an exception to the rule that most packages work without
+changes.  The "numpy" module needs to be installed from `our own
+repository`__ rather than from the official source.
+
+.. __: 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)::
+
+    pip install git+https://bitbucket.org/pypy/numpy.git
+
+Alternatively, the direct way::
+
+    git clone https://bitbucket.org/pypy/numpy.git
+    cd numpy
+    pypy setup.py install
+
+
 .. _translate:
 
 Building from source