Skip to content

Commit ba9f0f6

Browse files
committed
doc/go1.18: mention register ABI on ARM64 and PPC64
For #47694. Change-Id: Ide378f4a34587027c3d84fed2126c5b9bd8f7287 Reviewed-on: https://go-review.googlesource.com/c/go/+/363694 Trust: Cherry Mui <[email protected]> Reviewed-by: Jeremy Faller <[email protected]>
1 parent aec5c2e commit ba9f0f6

File tree

1 file changed

+19
-6
lines changed

1 file changed

+19
-6
lines changed

doc/go1.18.html

Lines changed: 19 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -71,12 +71,6 @@ <h3 id="amd64">AMD64</h3>
7171
The <code>GOAMD64</code> environment variable defaults to <code>v1</code>.
7272
</p>
7373

74-
<h3 id="ppc64">PPC64</h3>
75-
76-
<p><!-- CL 353969 -->
77-
TODO: <a href="https://golang.org/cl/353969">https://golang.org/cl/353969</a>: internal/buildcfg: enable register ABI for PPC64
78-
</p>
79-
8074
<h3 id="riscv">RISC-V</h3>
8175

8276
<p><!-- golang.org/issue/47100, CL 334872 -->
@@ -170,6 +164,25 @@ <h2 id="runtime">Runtime</h2>
170164

171165
<h2 id="compiler">Compiler</h2>
172166

167+
<p><!-- https://golang.org/issue/40724 -->
168+
Go 1.17 <a href=go1.17#compiler>implemented</a> a new way of passing
169+
function arguments and results using registers instead of the stack
170+
on 64-bit x86 architecture on selected operating systems.
171+
Go 1.18 expands the supported platforms to include 64-bit ARM (<code>GOARCH=arm64</code>),
172+
big- and little-endian 64-bit PowerPC (<code>GOARCH=ppc64</code>, <code>ppc64le</code>),
173+
as well as 64-bit x86 architecture (<code>GOARCH=amd64</code>)
174+
on all operating systems.
175+
On 64-bit ARM and 64-bit PowerPC systems, benchmarking shows
176+
performance improvements of 10% or more.
177+
</p>
178+
179+
<p>
180+
As <a href=go1.17#compiler>mentioned</a> in the Go 1.17 release notes,
181+
this change does not affect the functionality of any safe Go code and
182+
is designed to have no impact on most assembly code. See the
183+
<a href=go1.17#compiler>Go 1.17 release notes</a> for more details.
184+
</p>
185+
173186
<p><!-- CL 298611 -->
174187
TODO: <a href="https://golang.org/cl/298611">https://golang.org/cl/298611</a>: cmd/compile: add -asan option
175188
</p>

0 commit comments

Comments
 (0)