From: Brad Fitzpatrick <bradfitz@golang.org>
Date: Tue, 27 Aug 2013 23:13:21 +0000 (-0700)
Subject: net/http: document Request.Body more
X-Git-Tag: go1.2rc2~411
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=2ede818ae0761fc57dc1b52b4c8673933a3ff3fa;p=gostls13.git

net/http: document Request.Body more

Fixes #6221

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/13289043
---

diff --git a/src/pkg/net/http/request.go b/src/pkg/net/http/request.go
index 603299df55..ccdf121117 100644
--- a/src/pkg/net/http/request.go
+++ b/src/pkg/net/http/request.go
@@ -105,7 +105,16 @@ type Request struct {
 	// following a hyphen uppercase and the rest lowercase.
 	Header Header
 
-	// The message body.
+	// Body is the request's body.
+	//
+	// For client requests, a nil body means the request has no
+	// body, such as a GET request. The HTTP Client's Transport
+	// is responsible for calling the Close method.
+	//
+	// For server requests, the Request Body is always non-nil
+	// but will return EOF immediately when no body is present.
+	// The Server will close the request body. The ServeHTTP
+	// Handler does not need to.
 	Body io.ReadCloser
 
 	// ContentLength records the length of the associated content.