Change the signature for all network bind calls.

sdk/lib/io/http.dart

 // Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 part of dart.io;
 
 /**
  * HTTP status codes.
  */
 abstract class HttpStatus {
@@ skipping 46 matching lines @@
 /**
  * HTTP server.
  */
 abstract class HttpServer implements Stream<HttpRequest> {
   // TODO(ajohnsen): Document with example, once the stream API is final.
   // TODO(ajohnsen): Add HttpServer.secure.
   /**
    * Starts listening for HTTP requests on the specified [address] and
    * [port].
    *
-   * The default value for [address] is 127.0.0.1, which will allow
-   * only incoming connections from the local host. To allow for
-   * incoming connection from the network use either the value 0.0.0.0
-   * to bind to all interfaces or the IP address of a specific
-   * interface.
+   * The [address] can either be a [String] or an
+   * [InternetAddress]. If [address] is a [String], [bind] will
+   * perform a [InternetAddress.lookup] and use the first value in the
+   * list. To listen on the loopback adapter, which will allow only
+   * incoming connections from the local host, use the value
+   * [InternetAddress.LOOPBACK_IP_V4] or
+   * [InternetAddress.LOOPBACK_IP_V6]. To allow for incoming
+   * connection from the network use either one of the values
+   * [InternetAddress.ANY_IP_V4] or [InternetAddress.ANY_IP_V6] to
+   * bind to all interfaces or the IP address of a specific interface.
    *
-   * If [port] has the value [:0:] (the default) an ephemeral port
-   * will be chosen by the system. The actual port used can be
-   * retrieved using the [:port:] getter.
+   * If an IP version 6 (IPv6) address is used, both IP version 6
+   * (IPv6) and version 4 (IPv4) connections will be accepted. To
+   * restrict this to version 6 (IPv6) only, use [HttpServer.listenOn]
+   * with a [ServerSocket] configured for IP version 6 connections
+   * only.
+   *
+   * If [port] has the value [:0:] an ephemeral port will be chosen by
+   * the system. The actual port used can be retrieved using the
+   * [port] getter.
    *
    * The optional argument [backlog] can be used to specify the listen
    * backlog for the underlying OS listen setup. If [backlog] has the
    * value of [:0:] (the default) a reasonable value will be chosen by
    * the system.
    */
-  static Future<HttpServer> bind([String address = "127.0.0.1",
-                                  int port = 0,
-                                  int backlog = 0])
+  static Future<HttpServer> bind(address,
+                                 int port,
+                                 {int backlog: 0})
       => _HttpServer.bind(address, port, backlog);
 
   /**
-   * Starts listening for HTTPS requests on the specified [address] and
-   * [port]. If a [port] of 0 is specified the server will choose an
-   * ephemeral port. The optional argument [backlog] can be used to
-   * specify the listen backlog for the underlying OS listen
-   * setup.
+   * The [address] can either be a [String] or an
+   * [InternetAddress]. If [address] is a [String], [bind] will
+   * perform a [InternetAddress.lookup] and use the first value in the
+   * list. To listen on the loopback adapter, which will allow only
+   * incoming connections from the local host, use the value
+   * [InternetAddress.LOOPBACK_IP_V4] or
+   * [InternetAddress.LOOPBACK_IP_V6]. To allow for incoming
+   * connection from the network use either one of the values
+   * [InternetAddress.ANY_IP_V4] or [InternetAddress.ANY_IP_V6] to
+   * bind to all interfaces or the IP address of a specific interface.
+   *
+   * If an IP version 6 (IPv6) address is used, both IP version 6
+   * (IPv6) and version 4 (IPv4) connections will be accepted. To
+   * restrict this to version 6 (IPv6) only, use [HttpServer.listenOn]
+   * with a [ServerSocket] configured for IP version 6 connections
+   * only.
+   *
+   * If [port] has the value [:0:] an ephemeral port will be chosen by
+   * the system. The actual port used can be retrieved using the
+   * [port] getter.
+   *
+   * The optional argument [backlog] can be used to specify the listen
+   * backlog for the underlying OS listen setup. If [backlog] has the
+   * value of [:0:] (the default) a reasonable value will be chosen by
+   * the system.
    *
    * The certificate with Distinguished Name [certificateName] is looked
    * up in the certificate database, and is used as the server certificate.
    * if [requestClientCertificate] is true, the server will request clients
    * to authenticate with a client certificate.
    */
 
-  static Future<HttpServer> bindSecure(String address,
+  static Future<HttpServer> bindSecure(address,
                                        int port,
                                        {int backlog: 0,
                                         String certificateName,
                                         bool requestClientCertificate: false})
       => _HttpServer.bindSecure(address,
                                 port,
                                 backlog,
                                 certificateName,
                                 requestClientCertificate);
 
@@ skipping 579 matching lines @@
 
   /**
    * Gets the [HttpResponse] object, used for sending back the response to the
    * client.
    */
   HttpResponse get response;
 }
 
 
 /**
- * HTTP response to be send back to the client.
+ * An [HttpResponse] represents the headers and data to be returned to
+ * a client in response to an HTTP request.
  *
  * This object has a number of properties for setting up the HTTP
  * header of the response. When the header has been set up the methods
  * from the [IOSink] can be used to write the actual body of the HTTP
  * response. When one of the [IOSink] methods is used for the
  * first time the request header is send. Calling any methods that
  * will change the header after it is sent will throw an exception.
  *
  * When writing string data through the [IOSink] the encoding used
  * will be determined from the "charset" parameter of the
@@ skipping 609 matching lines @@
 class RedirectLimitExceededException extends RedirectException {
   const RedirectLimitExceededException(List<RedirectInfo> redirects)
       : super("Redirect limit exceeded", redirects);
 }
 
 
 class RedirectLoopException extends RedirectException {
   const RedirectLoopException(List<RedirectInfo> redirects)
       : super("Redirect loop detected", redirects);
 }