Better documentation on Sets and Maps, and more.

sdk/lib/async/stream.dart

 // Copyright (c) 2013, 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.
 
 part of dart.async;
 
 // -------------------------------------------------------------------
 // Core Stream types
 // -------------------------------------------------------------------
 
@@ skipping 1015 matching lines @@
  * events of one kind into outgoing events of (possibly) another kind.
  *
  * Subscribing on the stream returned by [bind] is the same as subscribing on
  * the source stream, except that events are passed through the [transformer]
  * before being emitted. The transformer may generate any number and
  * types of events for each incoming event. Pauses on the returned
  * subscription are forwarded to this stream.
  *
  * An example that duplicates all data events:
  *
- *     class DoubleTransformer<T> extends StreamEventTransformerBase<T, T> {
+ *     class DoubleTransformer<T> extends StreamEventTransformer<T, T> {
  *       void handleData(T data, EventSink<T> sink) {
  *         sink.add(value);
  *         sink.add(value);
  *       }
  *     }
  *     someTypeStream.transform(new DoubleTransformer<Type>());
  *
  * The default implementations of the "handle" methods forward
  * the events unmodified. If using the default [handleData] the generic type [T]
  * needs to be assignable to [S].
@@ skipping 194 matching lines @@
    *
    * If a [moveNext] call has been made, it will complete with `false` as value,
    * as will all further calls to [moveNext].
    *
    * If you need to stop listening for values before the stream iterator is
    * automatically closed, you must call [cancel] to ensure that the stream
    * is properly closed.
    */
   void cancel();
 }