From 7b82d6b8b40d831f0ad2ee33a0fb8d798910fdf0 Mon Sep 17 00:00:00 2001 From: Dan Peterson Date: Sat, 1 Nov 2025 14:23:42 -0300 Subject: _content/doc/install: prefer make.bash for source install The source install directions use all.bash with a later mention of make.bash. This can lead to surprises when the tests take a long time or aren't reliable in certain environments. Change things to prefer make.bash with a mention of all.bash later. Updates golang/go#76142 Change-Id: Ibe5ea3b1c2da3733ed8e36f4938cae754bd3a027 Reviewed-on: https://go-review.googlesource.com/c/website/+/717040 LUCI-TryBot-Result: Go LUCI Reviewed-by: Cherry Mui Reviewed-by: Robert Findley --- _content/doc/install/source.html | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) diff --git a/_content/doc/install/source.html b/_content/doc/install/source.html index bcafecf6..8e777dd6 100644 --- a/_content/doc/install/source.html +++ b/_content/doc/install/source.html @@ -138,7 +138,7 @@ The minimum version of Go required depends on the target version of Go:
  • 1.5 <= Go <= 1.19: a Go 1.4 compiler.
  • 1.20 <= Go <= 1.21: a Go 1.17 compiler.
  • 1.22 <= Go <= 1.23: a Go 1.20 compiler. -
  • Going forward, Go version 1.N will require a Go 1.M compiler, +
  • Going forward, Go version 1.N will require a Go 1.M compiler, where M is N-2 rounded down to an even number. Example: Go 1.24 and 1.25 require Go 1.22. @@ -313,11 +313,11 @@ To build the Go distribution, run
     $ cd src
    -$ ./all.bash
    +$ ./make.bash
     

    -(To build under Windows use all.bat.) +(To build under Windows use make.bat.)

    @@ -325,8 +325,6 @@ If all goes well, it will finish by printing output like:

    -ALL TESTS PASSED
    -
     ---
     Installed Go for linux/amd64 in /home/you/go.
     Installed commands in /home/you/go/bin.
    @@ -342,10 +340,8 @@ architecture, and root directory used during the install.
     

    For more information about ways to control the build, see the discussion of environment variables below. -all.bash (or all.bat) runs important tests for Go, -which can take more time than simply building Go. If you do not want to run -the test suite use make.bash (or make.bat) -instead. +You can also run all.bash (or all.bat) to run +important tests for Go, which can take more time than simply building Go.

    -- cgit v1.3