From: Damien Neil <dneil@google.com>
Date: Wed, 19 Apr 2023 19:31:27 +0000 (-0700)
Subject: doc: add release notes for new context functions
X-Git-Tag: go1.21rc1~838
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=b4b70a4617fa318ae3e3f3b3d1bb9241d4dc0f9e;p=gostls13.git

doc: add release notes for new context functions

For #40221
For #56661
For #57928

Change-Id: Iaf7425bb26eeb9c23235d13c786d5bb572159481
Reviewed-on: https://go-review.googlesource.com/c/go/+/486535
Run-TryBot: Damien Neil <dneil@google.com>
Reviewed-by: Sameer Ajmani <sameer@golang.org>
TryBot-Result: Gopher Robot <gobot@golang.org>
---

diff --git a/doc/go1.21.html b/doc/go1.21.html
index 911a8ddd19..e5c49912dd 100644
--- a/doc/go1.21.html
+++ b/doc/go1.21.html
@@ -84,6 +84,27 @@ Do not send CLs removing the interior tags from such phrases.
   TODO: complete this section
 </p>
 
+<dl id="context"><dt><a href="/pkg/context/">sync</a></dt>
+  <dd>
+    <p><!-- https://go.dev/issue/40221, CL 479918 -->
+      The new <a href="/pkg/context/#WithoutCancel"><code>WithoutCancel</code></a>
+      function returns a copy of a context that is not canceled when the original
+      context is canceled.
+    </p>
+    <p><!-- https://go.dev/issue/56661, CL 449318 -->
+      The new <a href="/pkg/context/#WithDeadlineCause"><code>WithDeadlineCause</code></a>
+      and <a href="/pkg/context/#WithTimeoutCause"><code>WithTimeoutCause</code></a>
+      functions provide a way to set a context cancellation cause when a deadline or
+      timer expires. The cause may be retrieved with the
+      <a href="/pkg/context/#Cause"><code>Cause</code></a> function.
+    </p>
+    <p><!-- https://go.dev/issue/57928, CL 482695 -->
+      The new <a href="/pkg/context/#AfterFunc"><code>AfterFunc</code></a>
+      function registers a function to run after a context has been cancelled.
+    </p>
+  </dd>
+</dl>
+
 <dl id="sync"><dt><a href="/pkg/sync/">sync</a></dt>
   <dd>
     <p><!-- https://go.dev/issue/56102, CL 451356 -->