From 1948c00b6e49b4481ab1378247020786db1b7129 Mon Sep 17 00:00:00 2001
From: Cherry Zhang <cherryyz@google.com>
Date: Wed, 4 Nov 2020 12:40:35 -0500
Subject: [PATCH] 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>
---
 doc/go1.16.html | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/doc/go1.16.html b/doc/go1.16.html
index 98fa595ea5..793f6ef26d 100644
--- a/doc/go1.16.html
+++ b/doc/go1.16.html
@@ -31,6 +31,29 @@ Do not send CLs removing the interior tags from such phrases.
 
 <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 -->
-- 
2.50.0