1
0
mirror of https://github.com/golang/go synced 2024-11-14 15:30:54 -07:00
go/src/cmd/dist
Ian Lance Taylor 2a2a283418 cmd/dist: don't run moved_goroot test on android, iOS, Plan 9
Fails on iOS because CC_FOR_TARGET points to clangwrap.sh in the
original GOROOT. We could fix that but it doesn't seem worth it.

Fails on Android with "exec format error". I'm not sure why but I
doubt it is interesting.

Fails on Plan 9 because the original GOROOT is being preserved in some
unknown way. This is issue #21016.

Updates #21016

Change-Id: I4e7115d734fc7bf21e5a2ba18fb6ad0bfa31c735
Reviewed-on: https://go-review.googlesource.com/48650
Run-TryBot: Ian Lance Taylor <iant@golang.org>
Reviewed-by: David du Colombier <0intro@gmail.com>
Reviewed-by: Elias Naur <elias.naur@gmail.com>
TryBot-Result: Gobot Gobot <gobot@golang.org>
2017-07-15 14:13:24 +00:00
..
build.go cmd/dist: ensure android-implies-linux for file names in dist 2017-05-24 03:09:15 +00:00
buildgo.go
buildruntime.go cmd/internal/objabi: extract shared functionality from obj 2017-04-19 00:00:09 +00:00
buildtool.go cmd/internal/objabi: extract shared functionality from obj 2017-04-19 00:00:09 +00:00
cpuid_386.s
cpuid_amd64.s
cpuid_default.s
deps.go cmd/go: include GOARM and GO386 in computed build ID 2017-05-23 21:39:36 +00:00
main.go
mkdeps.bash
README
sys_default.go
sys_windows.go
test_linux.go
test.go cmd/dist: don't run moved_goroot test on android, iOS, Plan 9 2017-07-15 14:13:24 +00:00
util_gc.go
util_gccgo.go
util.go
vfp_arm.s
vfp_default.s

This program, dist, is the bootstrapping tool for the Go distribution.

As of Go 1.5, dist and other parts of the compiler toolchain are written
in Go, making bootstrapping a little more involved than in the past.
The approach is to build the current release of Go with an earlier one.

The process to install Go 1.x, for x ≥ 5, is:

1. Build cmd/dist with Go 1.4.
2. Using dist, build Go 1.x compiler toolchain with Go 1.4.
3. Using dist, rebuild Go 1.x compiler toolchain with itself.
4. Using dist, build Go 1.x cmd/go (as go_bootstrap) with Go 1.x compiler toolchain.
5. Using go_bootstrap, build the remaining Go 1.x standard library and commands.

NOTE: During the transition from the old C-based toolchain to the Go-based one,
step 2 also builds the parts of the toolchain written in C, and step 3 does not
recompile those.

Because of backward compatibility, although the steps above say Go 1.4,
in practice any release ≥ Go 1.4 but < Go 1.x will work as the bootstrap base.

See golang.org/s/go15bootstrap for more details.

Compared to Go 1.4 and earlier, dist will also take over much of what used to
be done by make.bash/make.bat/make.rc and all of what used to be done by
run.bash/run.bat/run.rc, because it is nicer to implement that logic in Go
than in three different scripting languages simultaneously.