From: Paul E. Murphy <murp@ibm.com>
Date: Wed, 7 Jun 2023 19:42:51 +0000 (-0500)
Subject: doc/go1.21: document GOPPC64=power10 changes
X-Git-Tag: go1.21rc1~13
X-Git-Url: http://www.git.cypherpunks.ru/?a=commitdiff_plain;h=e712759914afa063076bcf5207a93cafd003f7bc;p=gostls13.git

doc/go1.21: document GOPPC64=power10 changes

For #44549

Change-Id: I1af1d4bbd01a4571a32815bfea16bc395524551a
Reviewed-on: https://go-review.googlesource.com/c/go/+/501358
TryBot-Result: Gopher Robot <gobot@golang.org>
Reviewed-by: Lynn Boger <laboger@linux.vnet.ibm.com>
Run-TryBot: Paul Murphy <murp@ibm.com>
Reviewed-by: Cherry Mui <cherryyz@google.com>
Reviewed-by: Eli Bendersky <eliben@google.com>
---

diff --git a/doc/go1.21.html b/doc/go1.21.html
index b5c473113d..1d49084325 100644
--- a/doc/go1.21.html
+++ b/doc/go1.21.html
@@ -1203,6 +1203,22 @@ Do not send CLs removing the interior tags from such phrases.
   need to rename them.
 </p>
 
+<h3 id="PPC64">ppc64/ppc64le</h3>
+
+<p><!-- go.dev/issue/44549 -->
+  On Linux, <code>GOPPC64=power10</code> now generates PC-relative instructions, prefixed
+  instructions, and other new Power10 instructions. On AIX, <code>GOPPC64=power10</code>
+  generates Power10 instructions, but does not generate PC-relative instructions.
+</p>
+
+<p>
+  When building position-independent binaries for <code>GOPPC64=power10</code>
+  <code>GOOS=linux</code> <code>GOARCH=ppc64le</code>, users can expect reduced binary
+  sizes in most cases, in some cases 3.5%. Position-independent binaries are built for
+  ppc64le with the following <code>-buildmode</code> values:
+  <code>c-archive</code>, <code>c-shared</code>, <code>shared</code>, <code>pie</code>, <code>plugin</code>.
+</p>
+
 
 <!-- proposals for x repos that don't need to be mentioned here but
      are picked up by the relnote tool. -->