1This program, dist, is the bootstrapping tool for the Go distribution.
2
3As of Go 1.5, dist and other parts of the compiler toolchain are written
4in Go, making bootstrapping a little more involved than in the past.
5The approach is to build the current release of Go with an earlier one.
6
7The process to install Go 1.x, for x ≥ 22, is:
8
91. Build cmd/dist with Go 1.20.6.
102. Using dist, build Go 1.x compiler toolchain with Go 1.20.6.
113. Using dist, rebuild Go 1.x compiler toolchain with itself.
124. Using dist, build Go 1.x cmd/go (as go_bootstrap) with Go 1.x compiler toolchain.
135. Using go_bootstrap, build the remaining Go 1.x standard library and commands.
14
15Because of backward compatibility, although the steps above say Go 1.20.6,
16in practice any release ≥ Go 1.20.6 but < Go 1.x will work as the bootstrap base.
17Releases ≥ Go 1.x are very likely to work as well.
18
19See https://go.dev/s/go15bootstrap for more details about the original bootstrap
20and https://go.dev/issue/54265 for details about later bootstrap version bumps.
21
View as plain text