From d6d0fec43d1770f460fdbc960996b2820ee11694 Mon Sep 17 00:00:00 2001
From: Damien Neil <dneil@google.com>
Date: Tue, 6 Jun 2023 14:19:45 -0700
Subject: [PATCH] go1.21: document net/http.ResponseController.EnableFullDuplex

For #15527
For #57786

Change-Id: I75ed0b4bac8e31fac2afef17dad708dc9a3d74e1
Reviewed-on: https://go-review.googlesource.com/c/go/+/501300
Run-TryBot: Damien Neil <dneil@google.com>
Auto-Submit: Damien Neil <dneil@google.com>
TryBot-Result: Gopher Robot <gobot@golang.org>
Reviewed-by: Ian Lance Taylor <iant@google.com>
---
 doc/go1.21.html | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/doc/go1.21.html b/doc/go1.21.html
index f7ffc19117..daaa3444b7 100644
--- a/doc/go1.21.html
+++ b/doc/go1.21.html
@@ -740,12 +740,18 @@ Do not send CLs removing the interior tags from such phrases.
 
 <dl id="net/http"><dt><a href="/pkg/net/http/">net/http</a></dt>
   <dd>
-    <p><!-- https://go.dev/issue/44855, CL 382117 -->
-      The new <a href="/pkg/net/http/#ErrSchemeMismatch"><code>ErrSchemeMismatch</code></a> error is returned by <a href="/pkg/net/http/#Client"><code>Client</code></a> and <a href="/pkg/net/http/#Transport"><code>Transport</code></a> when the server responds to an HTTPS request with an HTTP response.
+    <p><!-- CL 472636 -->
+      The new <a href="/pkg/net/http#ResponseController.EnableFullDuplex"><code>ResponseController.EnableFullDuplex</code></a>
+      method allows server handlers to concurrently read from an HTTP/1
+      request body while writing the response. Normally, the HTTP/1 server
+      automatically consumes any remaining request body before starting to
+      write the response, to avoid deadlocking clients which attempt to
+      write a complete request before reading the response. The
+      <code>EnableFullDuplex</code> method disables this behavior.
     </p>
 
-    <p><!-- CL 472636 -->
-      TODO: <a href="https://go.dev/cl/472636">https://go.dev/cl/472636</a>: net/http: support full-duplex HTTP/1 responses; modified api/next/57786.txt
+    <p><!-- https://go.dev/issue/44855, CL 382117 -->
+      The new <a href="/pkg/net/http/#ErrSchemeMismatch"><code>ErrSchemeMismatch</code></a> error is returned by <a href="/pkg/net/http/#Client"><code>Client</code></a> and <a href="/pkg/net/http/#Transport"><code>Transport</code></a> when the server responds to an HTTPS request with an HTTP response.
     </p>
 
     <p><!-- CL 494122 -->
-- 
2.44.0