diff --git a/src/pkg/http/server.go b/src/pkg/http/server.go
index f9771f9b410..f0b608ddebf 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)
 }