cmd/go: document default GOARM value

For #24904
For #58884

Change-Id: I0fc61f1a0bc6ebb22bdfd7a7b13ef36c68879384
Reviewed-on: https://go-review.googlesource.com/c/go/+/639276
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Ian Lance Taylor <iant@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Commit-Queue: Ian Lance Taylor <iant@google.com>
Auto-Submit: Ian Lance Taylor <iant@google.com>
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>

diff --git a/src/cmd/go/alldocs.go b/src/cmd/go/alldocs.go
index 5edd93599e56d8c55321681ab4d6cb1eae391833..548cf171ca78406fe00b0bedcfb84d4c0e3f0820 100644 (file)
--- a/src/cmd/go/alldocs.go
+++ b/src/cmd/go/alldocs.go
@@ -2448,6 +2448,11 @@
 //     GOARM
 //             For GOARCH=arm, the ARM architecture for which to compile.
 //             Valid values are 5, 6, 7.
+//             When the Go tools are built on an arm system,
+//             the default value is set based on what the build system supports.
+//             When the Go tools are not built on an arm system
+//             (that is, when building a cross-compiler),
+//             the default value is 7.
 //             The value can be followed by an option specifying how to implement floating point instructions.
 //             Valid options are ,softfloat (default for 5) and ,hardfloat (default for 6 and 7).
 //     GOARM64

diff --git a/src/cmd/go/internal/help/helpdoc.go b/src/cmd/go/internal/help/helpdoc.go
index 3db3ed06b2c9e335b0f8ed105ff75c1e712bcd5a..3e7a1cbc75dd430012dc25632ec3b09837be5c9c 100644 (file)
--- a/src/cmd/go/internal/help/helpdoc.go
+++ b/src/cmd/go/internal/help/helpdoc.go
@@ -620,6 +620,11 @@ Architecture-specific environment variables:
        GOARM
                For GOARCH=arm, the ARM architecture for which to compile.
                Valid values are 5, 6, 7.
+               When the Go tools are built on an arm system,
+               the default value is set based on what the build system supports.
+               When the Go tools are not built on an arm system
+               (that is, when building a cross-compiler),
+               the default value is 7.
                The value can be followed by an option specifying how to implement floating point instructions.
                Valid options are ,softfloat (default for 5) and ,hardfloat (default for 6 and 7).
        GOARM64