Change the signature for all network bind calls.

sdk/lib/io/secure_server_socket.dart

Index: sdk/lib/io/secure_server_socket.dart
diff --git a/sdk/lib/io/secure_server_socket.dart b/sdk/lib/io/secure_server_socket.dart
index 851b58d3a7a3c6d89a6f31d1e9a95c4101a80aec..5300b314c3ced7d6b8b1a57a55147c467b00fe25 100644
--- a/sdk/lib/io/secure_server_socket.dart
+++ b/sdk/lib/io/secure_server_socket.dart
@@ -20,12 +20,25 @@ class SecureServerSocket extends Stream<SecureSocket> implements ServerSocket {
    * completes the server socket is bound to the given [address] and
    * [port] and has started listening on it.
    *
-   * 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.
+   * 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

[Anders Johnsen, 2013/05/01 07:50:19]

Will LOOPBACK_IP_V6 and ANY_IP_V6 allow IPv4 as well?

[Søren Gjesse, 2013/05/01 07:55:20]

We have to decide on what the default should be and then update the comment. See
previous message on this CL.

+   * 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 [backlog] has the value of [:0:] a reasonable value will be
-   * chosen by the system.
+   * 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.
    *
    * Incoming client connections are promoted to secure connections, using
    * the server certificate given by [certificateName].
@@ -47,17 +60,17 @@ class SecureServerSocket extends Stream<SecureSocket> implements ServerSocket {
    * was received, the result will be null.
    */
   static Future<SecureServerSocket> bind(
-      String address,
+      address,
       int port,
-      int backlog,
       String certificateName,
-      {bool requestClientCertificate: false,
+      {int backlog: 0,
+       bool requestClientCertificate: false,
        bool requireClientCertificate: false}) {
     return RawSecureServerSocket.bind(
         address,
         port,
-        backlog,
         certificateName,
+        backlog: backlog,
         requestClientCertificate: requestClientCertificate,
         requireClientCertificate: requireClientCertificate).then(
             (serverSocket) => new SecureServerSocket._(serverSocket));
@@ -118,12 +131,25 @@ class RawSecureServerSocket extends Stream<RawSecureSocket> {
    * completes the server socket is bound to the given [address] and
    * [port] and has started listening on it.
    *
-   * 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.
+   * 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:] an ephemeral port will be chosen by
+   * the system. The actual port used can be retrieved using the
+   * [port] getter.
    *
-   * If [backlog] has the value of [:0:] a reasonable value will be
-   * chosen by the system.
+   * 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.
    *
    * Incoming client connections are promoted to secure connections,
    * using the server certificate given by [certificateName].
@@ -146,11 +172,11 @@ class RawSecureServerSocket extends Stream<RawSecureSocket> {
   static Future<RawSecureServerSocket> bind(
       String address,
       int port,
-      int backlog,
       String certificateName,
-      {bool requestClientCertificate: false,
+      {int backlog: 0,
+       bool requestClientCertificate: false,
        bool requireClientCertificate: false}) {
-    return RawServerSocket.bind(address, port, backlog)
+    return RawServerSocket.bind(address, port, backlog: backlog)
         .then((serverSocket) => new RawSecureServerSocket._(
             serverSocket,
             certificateName,