Clean-up of Future documentation and small fix-ups.

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 612 matching lines @@
    */
   Stream<T> handleError(Function onError, {bool test(error)}) {
     return new _HandleErrorStream<T>(this, onError, test);
   }
 
   /**
    * Transforms each element of this stream into a sequence of elements.
    *
    * Returns a new stream where each element of this stream is replaced
    * by zero or more data events.
-   * The event values are proveded as an [Iterable] by a call to [convert]
+   * The event values are provided as an [Iterable] by a call to [convert]
    * with the element as argument, and the elements of that iterable is
    * emitted in iteration order.
-   * If calling [convert] throws, or if iteration of the returned values throws,
-   * the error is emitted on the returned stream and iteration ends for that
-   * element of this stream.
+   * If calling [convert] throws, or if the iteration of the returned values
+   * throws, the error is emitted on the returned stream and iteration ends
+   * for that element of this stream.
    *
    * Error events and the done event of this stream are forwarded directly
    * to the returned stream.
    *
    * The returned stream is a broadcast stream if this stream is.
    * If a broadcast stream is listened to more than once, each subscription
    * will individually call `convert` and expand the events.
    */
   Stream<S> expand<S>(Iterable<S> convert(T element)) {
     return new _ExpandStream<T, S>(this, convert);
@@ skipping 1444 matching lines @@
   /// Must only be used instead of listening to the [values] stream.
   /// If the stream has been listened to, this call fails.
   /// After calling this method, listening on the [values] stream fails.
   Future cancel() {
     // If values has been listened to,
     // this throws a StateError saying that stream has already been listened to,
     // which is a correct error message for this call too.
     return values.listen(null).cancel();
   }
 }