go/src/cmd/dist
Than McIntosh 98bacdeafe internal/coverage: separate out cmd defs to separate package
Relocate the definitions in cmddefs.go (used by the compiler and
the cover tool) to a separate package "covcmd". No change
in functionality, this is a pure refactoring, in preparation
for a subsequent change that will require updating the
imports for the package.

Change-Id: Ic1d277c94d9a574de0a11ec5ed77e892302b9a47
Reviewed-on: https://go-review.googlesource.com/c/go/+/517696
TryBot-Result: Gopher Robot <gobot@golang.org>
Auto-Submit: Than McIntosh <thanm@google.com>
Run-TryBot: Than McIntosh <thanm@google.com>
Reviewed-by: David Chase <drchase@google.com>
2023-08-14 12:51:16 +00:00
..
README cmd/dist: fix broken link in README 2023-07-25 17:20:22 +00:00
build.go cmd/dist: tolerate macOS writing .DS_Store to GOROOT/bin 2023-08-01 22:28:15 +00:00
build_test.go cmd/link/internal/ld: move more of mustLinkExternal into internal/platform 2023-03-02 16:34:21 +00:00
buildgo.go cmd/dist: more robust cleanup 2023-06-13 20:44:00 +00:00
buildruntime.go internal/platform,cmd/dist: export the list of supported platforms 2023-06-22 19:44:52 +00:00
buildtag.go
buildtag_test.go cmd/dist: add buildtag parsing test 2021-11-25 00:02:52 +00:00
buildtool.go internal/coverage: separate out cmd defs to separate package 2023-08-14 12:51:16 +00:00
doc.go all: gofmt main repo 2022-04-11 16:34:30 +00:00
exec.go all: update build tags to require/assume Go 1.20 2023-07-20 21:52:09 +00:00
imports.go
main.go internal/platform,cmd/dist: export the list of supported platforms 2023-06-22 19:44:52 +00:00
notgo120.go all: update build tags to require/assume Go 1.20 2023-07-20 21:52:09 +00:00
quoted.go all: add missing copyright header 2022-11-09 14:05:53 +00:00
supported_test.go cmd/dist, internal/platform: test agreement on supported build modes 2023-01-31 16:54:46 +00:00
sys_default.go
sys_windows.go Revert "cmd/dist: log CPU model when testing" 2022-01-14 20:50:36 +00:00
test.go cmd/dist: update isUnsupportedVMASize test skip 2023-07-28 22:09:45 +00:00
testjson.go cmd/dist: handle -json flag in runPending (clean up) 2023-07-28 22:09:42 +00:00
testjson_test.go cmd/dist: flush incomplete lines in -json mode 2023-05-19 20:13:24 +00:00
util.go cmd/dist: default to GOARM=7 on all non-arm systems 2023-02-23 17:50:29 +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 ≥ 22, is:

1. Build cmd/dist with Go 1.20.6.
2. Using dist, build Go 1.x compiler toolchain with Go 1.20.6.
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.

Because of backward compatibility, although the steps above say Go 1.20.6,
in practice any release ≥ Go 1.20.6 but < Go 1.x will work as the bootstrap base.
Releases ≥ Go 1.x are very likely to work as well.

See https://go.dev/s/go15bootstrap for more details about the original bootstrap
and https://go.dev/issue/54265 for details about later bootstrap version bumps.