1
0
mirror of https://github.com/golang/go synced 2024-10-05 07:11:22 -06:00
go/src/cmd/dist
Shenghou Ma c3ecded729 cmd/dist: introduce list subcommand to list all supported platforms
Fixes #12270.

Change-Id: Ie3dcbd0403d270b4b7f5c39049e12315eee159ed
Reviewed-on: https://go-review.googlesource.com/19837
Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
Run-TryBot: Minux Ma <minux@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>
2016-02-24 06:41:08 +00:00
..
build.go cmd/dist: introduce list subcommand to list all supported platforms 2016-02-24 06:41:08 +00:00
buildgo.go cmd/dist: introduce list subcommand to list all supported platforms 2016-02-24 06:41:08 +00:00
buildruntime.go cmd/dist, runtime: make runtime version available as runtime.buildVersion 2015-12-16 05:42:40 +00:00
buildtool.go cmd/dist: added support for GOARCH=mips64{,le} 2015-11-12 04:54:40 +00:00
cpuid_386.s cmd/dist: fix bootstrapping with gccgo on 386 2015-04-15 16:58:19 +00:00
cpuid_amd64.s cmd/dist: use gccgo as bootstrap compiler 2015-04-13 19:10:16 +00:00
cpuid_default.s cmd/dist: use gccgo as bootstrap compiler 2015-04-13 19:10:16 +00:00
deps.go dwbug/elf: support old-style compressed DWARF 2015-12-03 20:53:04 +00:00
main.go cmd/dist: introduce list subcommand to list all supported platforms 2016-02-24 06:41:08 +00:00
mkdeps.bash cmd/dist: rewrite mkdeps.bash to work on OS X 2015-11-19 20:53:50 +00:00
README build: require old Go to build new Go (and convert cmd/dist to Go) 2015-01-10 19:16:00 +00:00
sys_default.go build: bootstrap on Plan 9 2015-01-13 07:50:32 +00:00
sys_windows.go build: update Windows make.bat for Go-based dist 2015-01-12 23:01:37 +00:00
test.go cmd/go: avoid race on test environment 2016-02-16 22:02:56 +00:00
util_gc.go cmd/dist: re-enable GOARM auto-detection 2015-09-10 22:43:07 +00:00
util_gccgo.go cmd/dist: re-enable GOARM auto-detection 2015-09-10 22:43:07 +00:00
util.go cmd/dist: restrict parallel tests to NumCPU on mips64x 2016-01-10 06:18:22 +00:00
vfp_arm.s cmd/dist: re-enable GOARM auto-detection 2015-09-10 22:43:07 +00:00
vfp_default.s cmd/dist: re-enable GOARM auto-detection 2015-09-10 22:43:07 +00:00

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.