1
0
mirror of https://github.com/golang/go synced 2024-11-08 07:36:21 -07:00
go/src/cmd/dist
Marvin Stenger 1b548dc5fb cmd/dist: rename variables + functions
This belongs to a series of clean-up changes (see below) for cmd/dist.
This is change (9).

These changes include:
(1)  apply minor fixes
(2)  restore behavior of branchtag
(3)  unleash bootstrap optimization for windows
(4)  use standard generated code header
(5)  remove trivial variables + functions
(6)  move functions for the better
(7)  simplify code segments
(8)  use bytes.Buffer for code generation
(9)  rename variables + functions

Change-Id: I9247433d7d07a2c99d15b0a4d23164bcbc042768
Reviewed-on: https://go-review.googlesource.com/61015
Run-TryBot: Ian Lance Taylor <iant@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Ian Lance Taylor <iant@golang.org>
2017-09-20 13:40:21 +00:00
..
build.go cmd/dist: rename variables + functions 2017-09-20 13:40:21 +00:00
buildgo.go cmd/dist: use bytes.Buffer for code generation 2017-09-20 03:48:42 +00:00
buildruntime.go cmd/dist: use bytes.Buffer for code generation 2017-09-20 03:48:42 +00:00
buildtool.go cmd/dist: simplify code segments 2017-09-20 01:16:36 +00:00
cpuid_386.s
cpuid_amd64.s
cpuid_default.s
deps_test.go cmd/go: test and fix missing deep dependencies in list Deps output 2017-08-19 03:33:15 +00:00
deps.go cmd/dist: use standard generated code header 2017-09-09 10:13:55 +00:00
doc.go cmd/dist: add doc file to fix go doc dist 2017-08-11 18:00:53 +00:00
main.go cmd/dist: rename variables + functions 2017-09-20 13:40:21 +00:00
mkdeps.bash cmd/dist: use standard generated code header 2017-09-09 10:13:55 +00:00
README
sys_default.go
sys_windows.go cmd/dist: rename variables + functions 2017-09-20 13:40:21 +00:00
test_linux.go cmd/go: ensure streaming test's stdout, stderr are same as cmd/go's 2016-12-07 01:12:22 +00:00
test.go all: correct location of go tool 2017-09-20 03:54:16 +00:00
util_gc.go cmd/dist: add -check-armv6k command to check for ARMv6K 2016-12-01 07:17:38 +00:00
util_gccgo.go cmd/dist: add -check-armv6k command to check for ARMv6K 2016-12-01 07:17:38 +00:00
util.go cmd/dist: rename variables + functions 2017-09-20 13:40:21 +00:00
vfp_arm.s cmd/dist: add -check-armv6k command to check for ARMv6K 2016-12-01 07:17:38 +00:00
vfp_default.s cmd/dist: add -check-armv6k command to check for ARMv6K 2016-12-01 07:17:38 +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.