From c2bb350d80fa6116094f819f48d83f1f34993295 Mon Sep 17 00:00:00 2001
From: Ian Lance Taylor <iant@golang.org>
Date: Fri, 26 May 2023 14:25:45 -0700
Subject: [PATCH] doc/go1.21: mention changes to the reflect package

Added Value.Clear, deprecated SliceHeader and StringHeader.

For #55002
For #56906

Change-Id: Ib7497aff830d56fad90c31ec28596e71a448e9ce
Reviewed-on: https://go-review.googlesource.com/c/go/+/498757
Reviewed-by: Ian Lance Taylor <iant@google.com>
Auto-Submit: Ian Lance Taylor <iant@google.com>
Run-TryBot: Ian Lance Taylor <iant@google.com>
Reviewed-by: Eli Bendersky <eliben@google.com>
Run-TryBot: Ian Lance Taylor <iant@golang.org>
TryBot-Result: Gopher Robot <gobot@golang.org>
---
 doc/go1.21.html | 24 +++++++++++++++---------
 1 file changed, 15 insertions(+), 9 deletions(-)

diff --git a/doc/go1.21.html b/doc/go1.21.html
index b959cdb116..88200bf33e 100644
--- a/doc/go1.21.html
+++ b/doc/go1.21.html
@@ -652,15 +652,21 @@ Do not send CLs removing the interior tags from such phrases.
     </p>
 
     <p><!-- https://go.dev/issue/55002 -->
-      TODO: <a href="https://go.dev/issue/55002">https://go.dev/issue/55002</a>: add Value.Clear
-    </p>
-
-    <p><!-- https://go.dev/issue/56906 -->
-      TODO: <a href="https://go.dev/issue/56906">https://go.dev/issue/56906</a>: deprecate SliceHeader and StringHeader
-    </p>
-
-    <p><!-- CL 452762 -->
-      TODO: <a href="https://go.dev/cl/452762">https://go.dev/cl/452762</a>: reflect: deprecate SliceHeader and StringHeader; modified api/next/56906.txt
+      The new <a href="/pkg/reflect/#Value"><code>Value</code></a>
+      method <a href="/pkg/reflect/#Value.Clear"><code>Value.Clear</code></a>
+      clears the contents of a map or zeros the contents of a slice.
+      This corresponds to the new <code>clear</code> built-in
+      <a href="#language">added to the language</a>.
+    </p>
+
+    <p><!-- https://go.dev/issue/56906, CL 452762 -->
+      The <a href="/pkg/reflect/#SliceHeader"><code>SliceHeader</code></a>
+      and <a href="/pkg/reflect/#StringHeader"><code>StringHeader</code></a>
+      types are now deprecated. In new code
+      prefer <a href="/pkg/unsafe/#Slice"><code>unsafe.Slice</code></a>,
+      <a href="/pkg/unsafe/#SliceData"><code>unsafe.SliceData</code></a>,
+      <a href="/pkg/unsafe/#String"><code>unsafe.String</code></a>,
+      or <a href="/pkg/unsafe/#StringData"><code>unsafe.StringData</code></a>.
     </p>
   </dd>
 </dl><!-- reflect -->
-- 
2.50.0