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