Comment and white-space cleanup in IO libraries.

runtime/bin/socket.dart

Index: runtime/bin/socket.dart
diff --git a/runtime/bin/socket.dart b/runtime/bin/socket.dart
index 58ee5045ea11395c60786b62d1ff71e926198c8a..7e9cec01b628704128190ddaaf63ba0c922d5c74 100644
--- a/runtime/bin/socket.dart
+++ b/runtime/bin/socket.dart
@@ -3,29 +3,29 @@
 // BSD-style license that can be found in the LICENSE file.
 
 interface ServerSocket default _ServerSocket {
-  /*
+  /**
    * Constructs a new server socket, binds it to a given address and port,
    * and listens on it.
    */
   ServerSocket(String bindAddress, int port, int backlog);
 
-  /*
+  /**
    * The connection handler gets called when there is a new incoming
    * connection on the socket.
    */
   void set connectionHandler(void callback(Socket connection));
 
-  /*
+  /**
    * The error handler gets called when a socket error occurs.
    */
   void set errorHandler(void callback());
 
-  /*
+  /**
    * Returns the port used by this socket.
    */
   int get port();
 
-  /*
+  /**
    * Closes the socket.
    */
   void close();
@@ -33,19 +33,19 @@ interface ServerSocket default _ServerSocket {
 
 
 interface Socket default _Socket {
-  /*
+  /**
    * Constructs a new socket and connects it to the given host on the given
    * port.
    */
   Socket(String host, int port);
 
-  /*
+  /**
    * Returns the number of received and non-read bytes in the socket that
    * can be read.
    */
   int available();
 
-  /*
+  /**
    * Reads up to [count] bytes of data from the socket and stores them into
    * buffer after buffer offset [offset]. The number of successfully read
    * bytes is returned. This function is non-blocking and will only read data
@@ -53,7 +53,7 @@ interface Socket default _Socket {
    */
   int readList(List<int> buffer, int offset, int count);
 
-  /*
+  /**
    * Writes up to [count] bytes of the buffer from [offset] buffer offset to
    * the socket. The number of successfully written bytes is returned. This
    * function is non-blocking and will only write data if buffer space is
@@ -61,51 +61,51 @@ interface Socket default _Socket {
    */
   int writeList(List<int> buffer, int offset, int count);
 
-  /*
+  /**
    * The connect handler gets called when connection to a given host
    * succeeded.
    */
   void set connectHandler(void callback());
 
-  /*
+  /**
    * The data handler gets called when data becomes available at the socket.
    */
   void set dataHandler(void callback());
 
-  /*
+  /**
    * The write handler gets called when the socket becomes available for
    * writing.
    */
   void set writeHandler(void callback());
 
-  /*
+  /**
    * The close handler gets called when a the last byte have been read
    * from a socket. At this point the socket might still be open for
    * writing for sending more data.
    */
   void set closeHandler(void callback());
 
-  /*
+  /**
    * The error handler gets called when a socket error occurs.
    */
   void set errorHandler(void callback());
 
-  /*
+  /**
    * Returns input stream to the socket.
    */
   InputStream get inputStream();
 
-  /*
+  /**
    * Returns output stream of the socket.
    */
   OutputStream get outputStream();
 
-  /*
+  /**
    * Returns the port used by this socket.
    */
   int get port();
 
-  /*
+  /**
    * Closes the socket. Calling [close] will never throw an exception
    * and calling it several times is supported. If [halfClose] is true
    * the socket will only be closed for writing and it might still be
@@ -119,9 +119,5 @@ interface Socket default _Socket {
 class SocketIOException implements Exception {
   const SocketIOException([String this.message = ""]);
   String toString() => "SocketIOException: $message";
-
-  /*
-   * Contains the exception message.
-   */
   final String message;
 }