doc: improve documentation for GOAMD64

The change clarifies in the release notes for go1.18 that the variable
is for compilation and references the microarchitecture description in
the Go Wiki,
https://golang.org/wiki/MinimumRequirements#amd64,
and references the same information in the output of go help
environment.

Fixes #50174

Change-Id: I6a7d5a06f48463a810c96cc9c76fe66113d5147c
Reviewed-on: https://go-review.googlesource.com/c/go/+/372194
Reviewed-by: Keith Randall <khr@golang.org>
Reviewed-by: Ian Lance Taylor <iant@golang.org>
Run-TryBot: Ian Lance Taylor <iant@golang.org>
TryBot-Result: Gopher Robot <gobot@golang.org>

diff --git a/doc/go1.18.html b/doc/go1.18.html
index a5d7dcfcc51f3171d1fa340e3a3be30e371ff669..0f313ee45432484277519e9c06fa9d3db2650d45 100644 (file)
--- a/doc/go1.18.html
+++ b/doc/go1.18.html
@@ -143,11 +143,12 @@ Do not send CLs removing the interior tags from such phrases.
 <h3 id="amd64">AMD64</h3>
 
 <p><!-- CL 349595 -->
-  Go 1.18 introduces the new <code>GOAMD64</code> environment variable which selects
-  a version of the AMD64 architecture. Allowed values are <code>v1</code>,
+  Go 1.18 introduces the new <code>GOAMD64</code> environment variable, which selects
+  a mininum target version of the AMD64 architecture. Allowed values are <code>v1</code>,
   <code>v2</code>, <code>v3</code>, or <code>v4</code>. Each higher level requires,
-  and takes advantage of, additional processor features.  A detailed description of the
-  versions is <a href="https://en.wikipedia.org/wiki/X86-64#Microarchitecture_levels">here</a>.
+  and takes advantage of, additional processor features. A detailed
+  description can be found
+  <a href="https://golang.org/wiki/MinimumRequirements#amd64">here</a>.
 </p>
 <p>
   The <code>GOAMD64</code> environment variable defaults to <code>v1</code>.

diff --git a/src/cmd/go/alldocs.go b/src/cmd/go/alldocs.go
index d90321414a72ea2d0a4222841e0e11623ae8a00c..3bb9d146b21ae44568ba8e039c1374fefe78474f 100644 (file)
--- a/src/cmd/go/alldocs.go
+++ b/src/cmd/go/alldocs.go
@@ -2131,7 +2131,7 @@
 //     GOAMD64
 //             For GOARCH=amd64, the microarchitecture level for which to compile.
 //             Valid values are v1 (default), v2, v3, v4.
-//             See https://en.wikipedia.org/wiki/X86-64#Microarchitecture_levels.
+//             See https://golang.org/wiki/MinimumRequirements#amd64
 //     GOMIPS
 //             For GOARCH=mips{,le}, whether to use floating point instructions.
 //             Valid values are hardfloat (default), softfloat.

diff --git a/src/cmd/go/internal/help/helpdoc.go b/src/cmd/go/internal/help/helpdoc.go
index 035235fe1b5a1d39a3e8228daa20362fee8af86c..7dc066cfbad6cc9262a9b3a451c1bf5d618ab95e 100644 (file)
--- a/src/cmd/go/internal/help/helpdoc.go
+++ b/src/cmd/go/internal/help/helpdoc.go
@@ -595,7 +595,7 @@ Architecture-specific environment variables:
        GOAMD64
                For GOARCH=amd64, the microarchitecture level for which to compile.
                Valid values are v1 (default), v2, v3, v4.
-               See https://en.wikipedia.org/wiki/X86-64#Microarchitecture_levels.
+               See https://golang.org/wiki/MinimumRequirements#amd64
        GOMIPS
                For GOARCH=mips{,le}, whether to use floating point instructions.
                Valid values are hardfloat (default), softfloat.