doc/go1.16: add release notes for darwin ports
Updates #38485, #42100.
For #40700.
Change-Id: I2caaa8482f13f9b79d4c2d2fdd242543981060cf
Reviewed-on: https://go-review.googlesource.com/c/go/+/267718
Trust: Cherry Zhang <cherryyz@google.com>
Reviewed-by: Ian Lance Taylor <iant@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
diff --git a/doc/go1.16.html b/doc/go1.16.html
index 98fa595..793f6ef 100644
--- a/doc/go1.16.html
+++ b/doc/go1.16.html
@@ -31,6 +31,29 @@
<h2 id="ports">Ports</h2>
+<h3 id="darwin">Darwin</h3>
+
+<p><!-- golang.org/issue/38485, golang.org/issue/41385, many CLs -->
+ Go 1.16 adds support of 64-bit ARM architecture on macOS (also known as
+ Apple Silicon) with <code>GOOS=darwin</code>, <code>GOARCH=arm64</code>.
+ Like the <code>darwin/amd64</code> port, the <code>darwin/arm64</code>
+ port supports cgo, internal and external linking, <code>c-archive</code>,
+ <code>c-shared</code>, and <code>pie</code> build modes, and the race
+ detector.
+</p>
+
+<p>
+ The iOS port, which was previously <code>darwin/arm64</code>, is now
+ moved to <code>ios/arm64</code>. <code>GOOS=ios</code> implies the
+ <code>darwin</code> build tag, just as <code>GOOS=android</code>
+ implies the <code>linux</code> build tag.
+</p>
+
+<p><!-- golang.org/issue/42100, CL 263798 -->
+ The <code>ios/amd64</code> port is added, targetting the iOS simulator
+ running on AMD64-based macOS.
+</p>
+
<h3 id="netbsd">NetBSD</h3>
<p><!-- golang.org/issue/30824 -->
