From 559b17fe3422f070d6cb8e68ac2ac12431d78b43 Mon Sep 17 00:00:00 2001
From: Michael Pratt <mpratt@google.com>
Date: Thu, 2 Jun 2022 16:43:12 -0400
Subject: [PATCH] doc/go1.19: add release notes for sync/atomic

For #51400

Change-Id: I32a3aedf1e8a52148a9d78c4f7dae1ea59c810b4
Reviewed-on: https://go-review.googlesource.com/c/go/+/410115
Run-TryBot: Michael Pratt <mpratt@google.com>
TryBot-Result: Gopher Robot <gobot@golang.org>
Reviewed-by: Michael Knyszek <mknyszek@google.com>
---
 doc/go1.19.html | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/doc/go1.19.html b/doc/go1.19.html
index be313f0f3b..e7387268ba 100644
--- a/doc/go1.19.html
+++ b/doc/go1.19.html
@@ -107,10 +107,34 @@ Do not send CLs removing the interior tags from such phrases.
 <p>
   TODO: complete this section, or delete if not needed
 </p>
+
 <h2 id="library">Core library</h2>
+
+<h3 id="atomic_types">New atomic types</h3>
+<p><!-- https://go.dev/issue/50860 --><!-- CL 381317 -->
+  The <a href="/pkg/sync/atomic/"><code>sync/atomic</code></a> package defines new atomic types
+  <a href="/pkg/sync/atomic/#Bool"><code>Bool</code></a>,
+  <a href="/pkg/sync/atomic/#Int32"><code>Int32</code></a>,
+  <a href="/pkg/sync/atomic/#Int64"><code>Int64</code></a>,
+  <a href="/pkg/sync/atomic/#Uint32"><code>Uint32</code></a>,
+  <a href="/pkg/sync/atomic/#Uint64"><code>Uint64</code></a>,
+  <a href="/pkg/sync/atomic/#Uintptr"><code>Uintptr</code></a>, and
+  <a href="/pkg/sync/atomic/#Pointer"><code>Pointer</code></a>.
+  These types hide the underlying values so that all accesses are forced to use
+  the atomic APIs.
+  <a href="/pkg/sync/atomic/#Pointer"><code>Pointer</code></a> also avoids
+  the need to convert to
+  <a href="/pkg/unsafe/#Pointer"><code>unsafe.Pointer</code></a> at call sites.
+  <a href="/pkg/sync/atomic/#Int64"><code>Int64</code></a> and
+  <a href="/pkg/sync/atomic/#Uint64"><code>Uint64</code></a> automatically
+  receive 64-bit alignment on ARM, 386, and 32-bit MIPS required for 64-bit
+  atomics on these systems.
+</p>
+
 <p>
   TODO: complete this section
 </p>
+
 <h3 id="minor_library_changes">Minor changes to the library</h3>
 <p>
   As always, there are various minor changes and updates to the library,
-- 
2.50.0