Improve documentation on address for socket bind

sdk/lib/io/http.dart

Index: sdk/lib/io/http.dart
diff --git a/sdk/lib/io/http.dart b/sdk/lib/io/http.dart
index 21830f26ec60cbb2ca5d0f337c8f4d03f6b35e1a..33da31a59bef7c5b2e2bc780c716c7744e0902c8 100644
--- a/sdk/lib/io/http.dart
+++ b/sdk/lib/io/http.dart
@@ -62,10 +62,20 @@ abstract class HttpServer implements Stream<HttpRequest> {
   // TODO(ajohnsen): Add HttpServer.secure.
   /**
    * Starts listening for HTTP 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.
+   * [port].
+

[Anders Johnsen, 2013/04/16 11:46:23]

add '   *'

[Søren Gjesse, 2013/04/16 12:04:18]

Done.

+   * 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.
+   *
+   * 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.

[Anders Johnsen, 2013/04/16 11:46:23]

you use both [port] and [:port:] here.

[Søren Gjesse, 2013/04/16 12:04:18]

Changed to just [port] even though it is two different ports (the port argument
and the port getter).

+   *
+   * The optional argument [backlog] can be used to specify the listen
+   * backlog for the underlying OS listen setup.

[Anders Johnsen, 2013/04/16 11:46:23]

Specify what 0 means.

[Søren Gjesse, 2013/04/16 12:04:18]

Done.

    */
   static Future<HttpServer> bind([String address = "127.0.0.1",
                                   int port = 0,