go/dist at d9f7ee9b94df6779fcaef64edf3a480459e3ef16 - go

History

qiulaidongfeng f617a6c8bf cmd/dist: remove unnecessary parts of bootstrapDirs Change-Id: I7658f2f1716f74b4ff0b4b9f8ccd386e99dd9d51 Change-Id: I7658f2f1716f74b4ff0b4b9f8ccd386e99dd9d51 GitHub-Last-Rev: `f55b84dafb` GitHub-Pull-Request: golang/go#61831 Reviewed-on: https://go-review.googlesource.com/c/go/+/516935 Reviewed-by: Michael Knyszek <mknyszek@google.com> Auto-Submit: Ian Lance Taylor <iant@google.com> TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Ian Lance Taylor <iant@google.com> Run-TryBot: Ian Lance Taylor <iant@google.com> Run-TryBot: Ian Lance Taylor <iant@golang.org>		2023-08-09 15:09:55 +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	cmd/dist: implement //go:build parsing	2021-10-28 03:35:04 +00:00
buildtag_test.go	cmd/dist: add buildtag parsing test	2021-11-25 00:02:52 +00:00
buildtool.go	cmd/dist: remove unnecessary parts of bootstrapDirs	2023-08-09 15:09:55 +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	all: go fmt std cmd (but revert vendor)	2021-02-20 03:54:50 +00:00
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	all: use more precise build tags	2021-02-23 19:55:03 +00:00
util_gccgo.go	all: go fmt std cmd (but revert vendor)	2021-02-20 03:54:50 +00:00
vfp_arm.s	all: add //go:build lines to assembly files	2021-05-13 09:12:17 +00:00
vfp_default.s	all: add //go:build lines to assembly files	2021-05-13 09:12:17 +00:00

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.