net/http: clarify docs on ResponseWriter.Write and Response.Write

[gopherbot]

by opennota:

When writing to the http.ResponseWriter, the http.Response's method Write doesn't do
what is expected.

    func handler(w http.ResponseWriter, r *http.Request) {
        resp, _ := client.Get("http://google.com/";)
        resp.Write(w)
    }

This will write resp's headers to the *body* of the handler's response, with the
text/plain content type.

A method that *copies* a Response would be helpful.

[bradfitz]

Comment 1:

We can't change the behavior here even if we wanted to, but we can clarify things in the
documentation.

Labels changed: added documentation, release-go1.5.

Status changed to Accepted.

[gopherbot]

CL https://golang.org/cl/9410 mentions this issue.

[bradfitz]

I don't think there's much more to do here. I looked at exporting the guts of net/http/httputil.ReverseProxy's copy function, but there's nothing to be extracted that can't be used via making a ReverseProxy and then calling its ServeHTTP.