1
0
mirror of https://github.com/golang/go synced 2024-10-05 09:21:22 -06:00
go/src/cmd/dist
Russ Cox 349ecfb0d6 cmd/gc: make cmd/gc a real library
cmd/gc contains symbol references into the back end dirs like 6g.
It also contains a few files that include the back end header files and
are compiled separately for each back end, despite being in cmd/gc.
cmd/gc also defines main, which makes at least one reverse symbol
reference unavoidable. (Otherwise you can't get into back-end code.)

This was all expedient, but it's too tightly coupled, especially for a
program written Go.

Make cmd/gc into a true library, letting the back end define main and
call into cmd/gc after making the necessary references available.
cmd/gc being a real library will ease the transition to Go.

Change-Id: I4fb9a0e2b11a32f1d024b3c56fc3bd9ee458842c
Reviewed-on: https://go-review.googlesource.com/3277
Reviewed-by: Rob Pike <r@golang.org>
2015-01-26 20:00:38 +00:00
..
build.go cmd/gc: make cmd/gc a real library 2015-01-26 20:00:38 +00:00
buildgc.go build: require old Go to build new Go (and convert cmd/dist to Go) 2015-01-10 19:16:00 +00:00
buildgo.go build: require old Go to build new Go (and convert cmd/dist to Go) 2015-01-10 19:16:00 +00:00
buildruntime.go build: implement GOEXPERIMENT again in runtime, and add to liblink 2015-01-21 00:44:18 +00:00
cpuid_386.s build: require old Go to build new Go (and convert cmd/dist to Go) 2015-01-10 19:16:00 +00:00
cpuid_amd64.s build: require old Go to build new Go (and convert cmd/dist to Go) 2015-01-10 19:16:00 +00:00
cpuid_default.s build: require old Go to build new Go (and convert cmd/dist to Go) 2015-01-10 19:16:00 +00:00
main.go build: require old Go to build new Go (and convert cmd/dist to Go) 2015-01-10 19:16:00 +00:00
README build: require old Go to build new Go (and convert cmd/dist to Go) 2015-01-10 19:16:00 +00:00
sys_default.go build: bootstrap on Plan 9 2015-01-13 07:50:32 +00:00
sys_windows.go build: update Windows make.bat for Go-based dist 2015-01-12 23:01:37 +00:00
util.go cmd/dist: fix deadlock when compilation command fails 2015-01-19 16:27:13 +00:00
vfp_arm.s cmd/dist: fix arm vfp detection 2015-01-12 21:07:26 +00:00
vfp_default.s build: require old Go to build new Go (and convert cmd/dist to Go) 2015-01-10 19:16:00 +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.