From: Brad Fitzpatrick <bradfitz@golang.org>
Date: Thu, 18 Jul 2013 00:10:10 +0000 (+1000)
Subject: net/http: document NewRequest treating Reader as ReadCloser
X-Git-Tag: go1.2rc2~1017
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=4aa6d353063aff777a9bdd3d3cedea5ca3fed2a4;p=gostls13.git

net/http: document NewRequest treating Reader as ReadCloser

R=golang-dev, dsymonds, rogpeppe
CC=golang-dev
https://golang.org/cl/11432044
---

diff --git a/src/pkg/net/http/request.go b/src/pkg/net/http/request.go
index 6d4569146f..3b29aefcd0 100644
--- a/src/pkg/net/http/request.go
+++ b/src/pkg/net/http/request.go
@@ -424,6 +424,10 @@ func ParseHTTPVersion(vers string) (major, minor int, ok bool) {
 }
 
 // NewRequest returns a new Request given a method, URL, and optional body.
+//
+// If the provided body is also an io.Closer, the returned
+// Request.Body is set to body and will be closed by the Client
+// methods Do, Post, and PostForm, and Transport.RoundTrip.
 func NewRequest(method, urlStr string, body io.Reader) (*Request, error) {
 	u, err := url.Parse(urlStr)
 	if err != nil {