[IO] Improve documentation for dart:io Socket.onWrite.

runtime/bin/socket.dart

 // Copyright (c) 2012, 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.
 
 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);
@@ skipping 56 matching lines @@
    * succeeded.
    */
   void set onConnect(void callback());
 
   /**
    * The data handler gets called when data becomes available at the socket.
    */
   void set onData(void callback());
 
   /**
-   * The write handler gets called when the socket becomes available for
-   * writing.
+   * The write handler gets called once when the socket becomes available for
+   * writing. Then the handler is reset to null. This handler is used when

[Søren Gjesse, 2012/07/06 04:02:11]

is reset -> is automatically reset

[Bill Hesse, 2012/07/06 08:41:25]

Done.

+   * writeList has reported an incomplete write, to schedule writing the
+   * remaining data to the socket.
    */
   void set onWrite(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 onClosed(void callback());
 
@@ skipping 55 matching lines @@
         sb.add(" ($osError)");
       }
     } else if (osError != null) {
       sb.add(": $osError");
     }
     return sb.toString();
   }
   final String message;
   final OSError osError;
 }