http: clarify ServeHTTP return

Fixes issue 580.

R=adg
CC=golang-dev
http://codereview.appspot.com/207086

1 files changed, 5 insertions, 0 deletions

diff --git a/src/pkg/http/server.go b/src/pkg/http/server.go
index f9771f9b4..f0b608dde 100644
--- a/src/pkg/http/server.go
+++ b/src/pkg/http/server.go
@@ -32,6 +32,11 @@ var (
 // Objects implementing the Handler interface can be
 // registered to serve a particular path or subtree
 // in the HTTP server.
+//
+// ServeHTTP should write reply headers and data to the Conn
+// and then return.  Returning signals that the request is finished
+// and that the HTTP server can move on to the next request on
+// the connection.
 type Handler interface {
 	ServeHTTP(*Conn, *Request)
 }