From: Rick Arnold <rickarnoldjr@gmail.com>
Date: Wed, 2 Jan 2013 22:37:27 +0000 (-0500)
Subject: net/http: document Request.URL
X-Git-Tag: go1.1rc2~1497
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=948f0b7a0bf2030bd927ccab7446324ed684d43f;p=gostls13.git

net/http: document Request.URL

Request.URL had no documentation before and some people were expecting all fields to be populated.

Fixes #3805.

R=golang-dev, rsc
CC=golang-dev
https://golang.org/cl/7008046
---

diff --git a/src/pkg/net/http/request.go b/src/pkg/net/http/request.go
index 0b6e6cbab5..f50e254fb2 100644
--- a/src/pkg/net/http/request.go
+++ b/src/pkg/net/http/request.go
@@ -71,7 +71,13 @@ var reqWriteExcludeHeader = map[string]bool{
 // or to be sent by a client.
 type Request struct {
 	Method string // GET, POST, PUT, etc.
-	URL    *url.URL
+
+	// URL is created from the URI supplied on the Request-Line
+	// as stored in RequestURI.
+	//
+	// For most requests, fields other than Path and RawQuery
+	// will be empty. (See RFC 2616, Section 5.1.2)
+	URL *url.URL
 
 	// The protocol version for incoming requests.
 	// Outgoing requests always use HTTP/1.1.