cmd/go: document GOTOOLCHAIN

For #57001.

Change-Id: I74c4abd675bd5636a029332b45ef0e6fdc36106f
Reviewed-on: https://go-review.googlesource.com/c/go/+/500795
TryBot-Result: Gopher Robot <gobot@golang.org>
Run-TryBot: Russ Cox <rsc@golang.org>
Reviewed-by: Michael Matloob <matloob@golang.org>

diff --git a/src/cmd/go/alldocs.go b/src/cmd/go/alldocs.go
index b872b7abe3a0b0159fac6a45eecf3e53b2db15ab..7ef763d6be6239c9bf7b6c88f8ccdc9506d73df4 100644 (file)
--- a/src/cmd/go/alldocs.go
+++ b/src/cmd/go/alldocs.go
@@ -2173,7 +2173,7 @@
 //             The operating system for which to compile code.
 //             Examples are linux, darwin, windows, netbsd.
 //     GOPATH
-//             For more details see: 'go help gopath'.
+//             Controls where various files are stored. See: 'go help gopath'.
 //     GOPROXY
 //             URL of Go module proxy. See https://golang.org/ref/mod#environment-variables
 //             and https://golang.org/ref/mod#module-proxy for details.
@@ -2187,6 +2187,8 @@
 //     GOSUMDB
 //             The name of checksum database to use and optionally its public key and
 //             URL. See https://golang.org/ref/mod#authenticating.
+//     GOTOOLCHAIN
+//             Controls which Go toolchain is used. See https://go.dev/doc/toolchain.
 //     GOTMPDIR
 //             The directory where the go command will write
 //             temporary source files, packages, and binaries.

diff --git a/src/cmd/go/internal/help/helpdoc.go b/src/cmd/go/internal/help/helpdoc.go
index 03cda98bbf09b378adc60ff4b86313a9d1ee6b52..68ac4d229daeae3e41c66f864a5cee191e579450 100644 (file)
--- a/src/cmd/go/internal/help/helpdoc.go
+++ b/src/cmd/go/internal/help/helpdoc.go
@@ -525,7 +525,7 @@ General-purpose environment variables:
                The operating system for which to compile code.
                Examples are linux, darwin, windows, netbsd.
        GOPATH
-               For more details see: 'go help gopath'.
+               Controls where various files are stored. See: 'go help gopath'.
        GOPROXY
                URL of Go module proxy. See https://golang.org/ref/mod#environment-variables
                and https://golang.org/ref/mod#module-proxy for details.
@@ -539,6 +539,8 @@ General-purpose environment variables:
        GOSUMDB
                The name of checksum database to use and optionally its public key and
                URL. See https://golang.org/ref/mod#authenticating.
+       GOTOOLCHAIN
+               Controls which Go toolchain is used. See https://go.dev/doc/toolchain.
        GOTMPDIR
                The directory where the go command will write
                temporary source files, packages, and binaries.