# HG changeset patch
# User Armin Rigo <arigo@tunes.org>
# Date 1522303447 -7200
#      Thu Mar 29 08:04:07 2018 +0200
# Branch extradoc
# Node ID b010de333e74d66906857a2e063096c69b3392cc
# Parent  913450bf91e9e98a4934be3e0465aaaf692ac042
Clarify how to build PyPy3 from sources

diff --git a/download.html b/download.html
--- a/download.html
+++ b/download.html
@@ -263,10 +263,16 @@
 <pre class="literal-block">
 hg clone https://bitbucket.org/pypy/pypy
 </pre>
-<p>Alternatively, the following smaller package contains the source at
+<p>The trunk contains PyPy 2.  For PyPy 3, switch to the correct branch:</p>
+<pre class="literal-block">
+# for PyPy 3: switch to the branch of PyPy that implements Python 3.5
+hg update py3.5
+</pre>
+<p>Alternatively, get one of the following smaller packages for the source at
 the same revision as the above binaries:</p>
 <ul class="simple">
-<li><a class="reference external" href="https://bitbucket.org/pypy/pypy/downloads/pypy2-v5.10.1-src.tar.bz2">pypy2-v5.10.1-src.tar.bz2</a> (sources)</li>
+<li><a class="reference external" href="https://bitbucket.org/pypy/pypy/downloads/pypy2-v5.10.1-src.tar.bz2">pypy2-v5.10.1-src.tar.bz2</a> (sources, PyPy 2 only)</li>
+<li><a class="reference external" href="https://bitbucket.org/pypy/pypy/downloads/pypy3-v5.10.1-src.tar.bz2">pypy3-v5.10.1-src.tar.bz2</a> (sources, PyPy 3 only)</li>
 </ul>
 </li>
 <li><p class="first">Make sure you <strong>installed the dependencies.</strong>  See the list <a class="reference external" href="http://pypy.readthedocs.org/en/latest/build.html#install-build-time-dependencies">here</a>.</p>
@@ -278,7 +284,7 @@
 </li>
 <li><p class="first">Run the <tt class="docutils literal">rpython</tt> script.  Here are the common combinations
 of options (works also with <tt class="docutils literal">python</tt> instead of <tt class="docutils literal">pypy</tt>;
-requires CPython 2.7 or PyPy 2):</p>
+requires CPython 2.7 or PyPy 2, even to build PyPy 3):</p>
 <pre class="literal-block">
 pypy ../../rpython/bin/rpython -Ojit targetpypystandalone           # get the JIT version
 pypy ../../rpython/bin/rpython -O2 targetpypystandalone             # get the no-jit version
diff --git a/source/download.txt b/source/download.txt
--- a/source/download.txt
+++ b/source/download.txt
@@ -301,12 +301,19 @@
 
      hg clone https://bitbucket.org/pypy/pypy
 
-   Alternatively, the following smaller package contains the source at
+   The trunk contains PyPy 2.  For PyPy 3, switch to the correct branch::
+
+     # for PyPy 3: switch to the branch of PyPy that implements Python 3.5
+     hg update py3.5
+
+   Alternatively, get one of the following smaller packages for the source at
    the same revision as the above binaries:
 
-   * `pypy2-v5.10.1-src.tar.bz2`__ (sources)
+   * `pypy2-v5.10.1-src.tar.bz2`__ (sources, PyPy 2 only)
+   * `pypy3-v5.10.1-src.tar.bz2`__ (sources, PyPy 3 only)
 
    .. __: https://bitbucket.org/pypy/pypy/downloads/pypy2-v5.10.1-src.tar.bz2
+   .. __: https://bitbucket.org/pypy/pypy/downloads/pypy3-v5.10.1-src.tar.bz2
 
 
 2. Make sure you **installed the dependencies.**  See the list here__.
@@ -319,7 +326,7 @@
 
 4. Run the ``rpython`` script.  Here are the common combinations
    of options (works also with ``python`` instead of ``pypy``;
-   requires CPython 2.7 or PyPy 2)::
+   requires CPython 2.7 or PyPy 2, even to build PyPy 3)::
 
      pypy ../../rpython/bin/rpython -Ojit targetpypystandalone           # get the JIT version
      pypy ../../rpython/bin/rpython -O2 targetpypystandalone             # get the no-jit version