Update comments for streams

runtime/bin/output_stream.dart

 // Copyright (c) 2011, 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.
 
 /**
- * Output is written to a given output stream. Such an output stream can
- * be an endpoint, e.g., a socket or a file, or another output stream.
- * Multiple output streams can be chained together to operate collaboratively
- * on a given output.
+ * Output streams are used to write data sequentially to a data
+ * destination e.g. a connected socket or an open file.
  *
  * An output stream provides internal buffering of the data written
  * through all calls to [write] and [writeFrom] if data cannot be
  * written immediately to the communication channel. The callback set
  * through [noPendingWriteHandler] can be used to to keep the rate of
  * writing in sync with the rate the system can actually write data to
  * the underlying communication channel.
  */
 interface OutputStream {
   /**
@@ skipping 50 matching lines @@
    */
   void set closeHandler(void callback());
 
   /**
    * Sets the handler that gets called when the underlying
    * communication channel gets into some kind of error situation.
    */
   void set errorHandler(void callback());
 }