net/http: clarify DefaultTransport docs

Fixes #4281

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/6872053

diff --git a/src/pkg/net/http/transport.go b/src/pkg/net/http/transport.go
index 0aec1ae51b53cf02c1f0a4e25db324963218dc5f..48f7ac0e53553504ce3d40335655d4b2f061d5bf 100644 (file)
--- a/src/pkg/net/http/transport.go
+++ b/src/pkg/net/http/transport.go
@@ -28,10 +28,10 @@ import (
 )
 
 // DefaultTransport is the default implementation of Transport and is
-// used by DefaultClient.  It establishes a new network connection for
-// each call to Do and uses HTTP proxies as directed by the
-// $HTTP_PROXY and $NO_PROXY (or $http_proxy and $no_proxy)
-// environment variables.
+// used by DefaultClient. It establishes network connections as needed
+// and caches them for reuse by subsequent calls. It uses HTTP proxies
+// as directed by the $HTTP_PROXY and $NO_PROXY (or $http_proxy and
+// $no_proxy) environment variables.
 var DefaultTransport RoundTripper = &Transport{Proxy: ProxyFromEnvironment}
 
 // DefaultMaxIdleConnsPerHost is the default value of Transport's