net/http: enhance documentation for Server.Addr

Fixes #31249 Change-Id: I3280f8ab170ed31d4efb71106533e016d430d44c Reviewed-on: https://go-review.googlesource.com/c/go/+/191557 Reviewed-by: Brad Fitzpatrick <[email protected]>
golang · Aug 27, 2019 · 2b59894 · 2b59894
1 parent 2ebc3d8
commit 2b59894
Showing 1 changed file with 6 additions and 1 deletion.
diff --git a/src/net/http/server.go b/src/net/http/server.go
@@ -2488,7 +2488,12 @@ func ServeTLS(l net.Listener, handler Handler, certFile, keyFile string) error {
 // A Server defines parameters for running an HTTP server.
 // The zero value for Server is a valid configuration.
 type Server struct {
-	Addr    string  // TCP address to listen on, ":http" if empty
+	// Addr optionally specifies the TCP address for the server to listen on,
+	// in the form "host:port". If empty, ":http" (port 80) is used.
+	// The service names are defined in RFC 6335 and assigned by IANA.
+	// See net.Dial for details of the address format.
+	Addr string
+
 	Handler Handler // handler to invoke, http.DefaultServeMux if nil
 
 	// TLSConfig optionally provides a TLS configuration for use