From: Brad Fitzpatrick <bradfitz@golang.org>
Date: Sat, 13 Dec 2014 08:00:48 +0000 (+1100)
Subject: net/http: document Response.Body Read+Close interaction with keep-alive
X-Git-Tag: go1.5beta1~2632
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=8476d4cf2937fc261bbcf2890ba39d815bce3ae5;p=gostls13.git

net/http: document Response.Body Read+Close interaction with keep-alive

Fixes #5645

Change-Id: Ifb46d6faf7ac838792920f6fe00912947478e761
Reviewed-on: https://go-review.googlesource.com/1531
Reviewed-by: David Symonds <dsymonds@golang.org>
---

diff --git a/src/net/http/response.go b/src/net/http/response.go
index 5d2c39080e..cfe695ce5c 100644
--- a/src/net/http/response.go
+++ b/src/net/http/response.go
@@ -48,7 +48,10 @@ type Response struct {
 	// The http Client and Transport guarantee that Body is always
 	// non-nil, even on responses without a body or responses with
 	// a zero-length body. It is the caller's responsibility to
-	// close Body.
+	// close Body. The default HTTP client's Transport does not
+	// attempt to reuse HTTP/1.0 or HTTP/1.1 TCP connections
+	// ("keep-alive") unless the Body is read to completion and is
+	// closed.
 	//
 	// The Body is automatically dechunked if the server replied
 	// with a "chunked" Transfer-Encoding.