go/src/cmd/dist
Austin Clements 9255688610 cmd/asm: rename -symabis to -gensymabis
Currently, both asm and compile have a -symabis flag, but in asm it's
a boolean flag that means to generate a symbol ABIs file and in the
compiler its a string flag giving the path of the symbol ABIs file to
consume. I'm worried about this false symmetry biting us in the
future, so rename asm's flag to -gensymabis.

Updates #27539.

Change-Id: I8b9c18a852d2838099718f8989813f19d82e7434
Reviewed-on: https://go-review.googlesource.com/c/149818
Run-TryBot: Austin Clements <austin@google.com>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Ian Lance Taylor <iant@golang.org>
2018-11-16 21:57:50 +00:00
..
README
build.go cmd/asm: rename -symabis to -gensymabis 2018-11-16 21:57:50 +00:00
buildgo.go cmd/dist, cmd/cgo, cmd/go: allow per-goos/goarch default CC 2017-11-06 20:20:37 +00:00
buildruntime.go cmd/dist: add AIX operating system. 2018-10-03 13:38:38 +00:00
buildtool.go cmd/link: add new loading package for XCOFF files 2018-10-23 14:05:04 +00:00
cpuid_386.s
cpuid_amd64.s
cpuid_default.s
doc.go cmd/dist: adjust package doc 2017-11-15 21:26:16 +00:00
imports.go
main.go cmd/dist: add AIX operating system. 2018-10-03 13:38:38 +00:00
sys_default.go
sys_windows.go cmd/dist: support windows/arm 2018-08-20 20:41:54 +00:00
test.go cmd/dist: make raceDetectorSupported an exact copy of cmd/internal/sys.RaceDetectorSupported 2018-09-12 18:26:21 +00:00
test_linux.go
util.go cmd/dist: default to GOARM=7 on android 2018-03-06 16:08:04 +00:00
util_gc.go
util_gccgo.go
vfp_arm.s
vfp_default.s

README

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.