diff --git a/doc/install-source.html b/doc/install-source.html index 356f0dfb80..22cc1d5dec 100644 --- a/doc/install-source.html +++ b/doc/install-source.html @@ -115,27 +115,39 @@ Go does not support CentOS 6 on these systems.
The Go tool chain is written in Go. To build it, you need a Go compiler installed.
The scripts that do the initial build of the tools look for an existing Go tool
-chain in $HOME/go1.4.
-(This path may be overridden by setting the GOROOT_BOOTSTRAP
-environment variable.)
+chain in $GOROOT_BOOTSTRAP.
+If unset, the default value of GOROOT_BOOTSTRAP
+is $HOME/go1.4.
-Build the tools with Go version 1.4 or a point release (1.4.1, 1.4.2 etc.).
-Go 1.4 binaries can be found at the downloads page.
+There are many options for the bootstrap tool chain.
+After obtaining one, set GOROOT_BOOTSTRAP to the
+directory containing the unpacked tree.
+For example, $GOROOT_BOOTSTRAP/bin/go should be
+the go command binary for the bootstrap tool chain.
-Download the zip or tarball of Go 1.4 for your platform and extract it to
-$HOME/go1.4 (or your nominated GOROOT_BOOTSTRAP
-location).
+To use a binary release as a bootstrap tool chain, see
+the downloads page or use any other
+packaged Go distribution.
-If you want to install Go 1.5 on a system that is not supported by Go 1.4 (such
-as linux/ppc64 and linux/mips64le) you can either use
-bootstrap.bash on a system that can bootstrap Go
-1.5 normally, or bootstrap with gccgo 5.
+To build a bootstrap tool chain from source, use
+either the git branch release-branch.go1.4 or
+go1.4-bootstrap-20161024.tar.gz,
+which contains the Go 1.4 source code plus accumulated fixes
+to keep the tools running on newer operating systems.
+(Go 1.4 was the last distribution in which the tool chain was written in C.)
+
+To cross-compile a bootstrap tool chain from source, which is
+necessary on systems Go 1.4 did not target (for
+example, linux/ppc64le), install Go on a different system
+and run bootstrap.bash.
@@ -154,8 +166,9 @@ and used as GOROOT_BOOTSTRAP to bootstrap a local build.
-To use gccgo, you need to arrange for $GOROOT_BOOTSTRAP/bin/go to be
-the go tool that comes as part of gccgo 5. For example on Ubuntu Vivid:
+To use gccgo as the bootstrap toolchain, you need to arrange
+for $GOROOT_BOOTSTRAP/bin/go to be the go tool that comes
+as part of gccgo 5. For example on Ubuntu Vivid: