Update prebuilts to go1.7rc1 ab/3043704
toolchain/go sha ffb9ee3a
Change-Id: I230dd018def6fd975e28add1eb70aae6c54ad5d7
diff --git a/doc/install-source.html b/doc/install-source.html
index e71fff7..991be3f 100644
--- a/doc/install-source.html
+++ b/doc/install-source.html
@@ -33,7 +33,7 @@
</p>
<p>
-The Go compilers support five instruction sets.
+The Go compilers support seven instruction sets.
There are important differences in the quality of the compilers for the different
architectures.
</p>
@@ -43,15 +43,17 @@
<code>amd64</code> (also known as <code>x86-64</code>)
</dt>
<dd>
- A mature implementation. The compiler has an effective
- optimizer (registerizer) and generates good code (although
- <code>gccgo</code> can do noticeably better sometimes).
+ A mature implementation. New in 1.7 is its SSA-based back end
+ that generates compact, efficient code.
</dd>
<dt>
<code>386</code> (<code>x86</code> or <code>x86-32</code>)
</dt>
<dd>
- Comparable to the <code>amd64</code> port.
+ Comparable to the <code>amd64</code> port, but does
+ not yet use the SSA-based back end. It has an effective
+ optimizer (registerizer) and generates good code (although
+ <code>gccgo</code> can do noticeably better sometimes).
</dd>
<dt>
<code>arm</code> (<code>ARM</code>)
@@ -63,13 +65,25 @@
<code>arm64</code> (<code>AArch64</code>)
</dt>
<dd>
- Supports Linux and Darwin binaries. New in 1.5 and not as well excercised as other ports.
+ Supports Linux and Darwin binaries. New in 1.5 and not as well exercised as other ports.
</dd>
<dt>
<code>ppc64, ppc64le</code> (64-bit PowerPC big- and little-endian)
</dt>
<dd>
- Supports Linux binaries. New in 1.5 and not as well excercised as other ports.
+ Supports Linux binaries. New in 1.5 and not as well exercised as other ports.
+</dd>
+<dt>
+ <code>mips64, mips64le</code> (64-bit MIPS big- and little-endian)
+</dt>
+<dd>
+ Supports Linux binaries. New in 1.6 and not as well exercised as other ports.
+</dd>
+<dt>
+ <code>s390x</code> (IBM System z)
+</dt>
+<dd>
+ Supports Linux binaries. New in 1.7 and not as well exercised as other ports.
</dd>
</dl>
@@ -87,6 +101,17 @@
<a href="#environment">environment variables</a> below.
</p>
+<p>
+See the main installation page for the <a href="/doc/install#requirements">overall system requirements</a>.
+The following additional constraints apply to systems that can be built only from source:
+</p>
+
+<ul>
+<li>For Linux on PowerPC 64-bit, the minimum supported kernel version is 2.6.37, meaning that
+Go does not support CentOS 6 on these systems.
+</li>
+</ul>
+
</div>
<h2 id="go14">Install Go compiler binaries</h2>
@@ -112,7 +137,7 @@
<p>
If you want to install Go 1.5 on a system that is not supported by Go 1.4 (such
-as <code>linux/ppc64</code>) you can either use
+as <code>linux/ppc64</code> and <code>linux/mips64le</code>) you can either use
<a href="/src/bootstrap.bash">bootstrap.bash</a> on a system that can bootstrap Go
1.5 normally, or bootstrap with gccgo 5.
</p>
@@ -133,7 +158,7 @@
</p>
<p>
-To use gccgo, you need to arrange for <code>$GOROOT_BOOSTRAP/bin/go</code> to be
+To use gccgo, you need to arrange for <code>$GOROOT_BOOTSTRAP/bin/go</code> to be
the go tool that comes as part of gccgo 5. For example on Ubuntu Vivid:
</p>
@@ -156,20 +181,40 @@
<a href="http://git-scm.com/downloads">Git downloads</a> page.
</p>
+<h2 id="ccompiler">(Optional) Install a C compiler</h2>
+
+<p>
+To build a Go installation
+with <code><a href="/cmd/cgo">cgo</a></code> support, which permits Go
+programs to import C libraries, a C compiler such as <code>gcc</code>
+or <code>clang</code> must be installed first. Do this using whatever
+installation method is standard on the system.
+</p>
+
+<p>
+To build without <code>cgo</code>, set the environment variable
+<code>CGO_ENABLED=0</code> before running <code>all.bash</code> or
+<code>make.bash</code>.
+</p>
<h2 id="fetch">Fetch the repository</h2>
<p>Go will install to a directory named <code>go</code>.
Change to the directory that will be its parent
and make sure the <code>go</code> directory does not exist.
-Then clone the repository and check out the latest release tag:</p>
+Then clone the repository and check out the latest release tag
+(<code class="versionTag">go1.6</code>, for example):</p>
<pre>
$ git clone https://go.googlesource.com/go
$ cd go
-$ git checkout go1.5
+$ git checkout <span class="versionTag"><i><tag></i></span>
</pre>
+<p class="whereTag">
+Where <code><tag></code> is the version string of the release.
+</p>
+
<h2 id="head">(Optional) Switch to the master branch</h2>
<p>If you intend to modify the go source code, and
@@ -346,7 +391,7 @@
<a href="//groups.google.com/group/golang-announce">golang-announce</a>
mailing list.
Each announcement mentions the latest release tag, for instance,
-<code>go1.5</code>.
+<code class="versionTag">go1.6</code>.
</p>
<p>
@@ -356,11 +401,13 @@
<pre>
$ cd go/src
$ git fetch
-$ git checkout <i><tag></i>
+$ git checkout <span class="versionTag"><i><tag></i></psan>
$ ./all.bash
</pre>
+<p class="whereTag">
Where <code><tag></code> is the version string of the release.
+</p>
<h2 id="environment">Optional environment variables</h2>
@@ -405,13 +452,17 @@
Choices for <code>$GOARCH</code> are
<code>amd64</code> (64-bit x86, the most mature port),
<code>386</code> (32-bit x86), <code>arm</code> (32-bit ARM), <code>arm64</code> (64-bit ARM),
-<code>ppc64le</code> (PowerPC 64-bit, little-endian), and <code>ppc64</code> (PowerPC 64-bit, big-endian).
+<code>ppc64le</code> (PowerPC 64-bit, little-endian), <code>ppc64</code> (PowerPC 64-bit, big-endian),
+<code>mips64le</code> (MIPS 64-bit, little-endian), and <code>mips64</code> (MIPS 64-bit, big-endian).
The valid combinations of <code>$GOOS</code> and <code>$GOARCH</code> are:
<table cellpadding="0">
<tr>
<th width="50"></th><th align="left" width="100"><code>$GOOS</code></th> <th align="left" width="100"><code>$GOARCH</code></th>
</tr>
<tr>
+<td></td><td><code>android</code></td> <td><code>arm</code></td>
+</tr>
+<tr>
<td></td><td><code>darwin</code></td> <td><code>386</code></td>
</tr>
<tr>
@@ -454,6 +505,12 @@
<td></td><td><code>linux</code></td> <td><code>ppc64le</code></td>
</tr>
<tr>
+<td></td><td><code>linux</code></td> <td><code>mips64</code></td>
+</tr>
+<tr>
+<td></td><td><code>linux</code></td> <td><code>mips64le</code></td>
+</tr>
+<tr>
<td></td><td><code>netbsd</code></td> <td><code>386</code></td>
</tr>
<tr>