add generic method comments to a few SDK methods

sdk/lib/collection/iterable.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.
 
 part of dart.collection;
 
 /**
  * This [Iterable] mixin implements all [Iterable] members except `iterator`.
  *
  * All other methods are implemented in terms of `iterator`.
  */
 abstract class IterableMixin<E> implements Iterable<E> {
   // This class has methods copied verbatim into:
   // - IterableBase
   // - SetMixin
   // If changing a method here, also change the other copies.
 
-  Iterable map(f(E element)) => new MappedIterable<E, dynamic>(this, f);
+  Iterable/*<T>*/ map/*<T>*/(/*=T*/ f(E element)) =>
+      new MappedIterable<E, dynamic/*=T*/>(this, f);
 
   Iterable<E> where(bool f(E element)) => new WhereIterable<E>(this, f);
 
-  Iterable expand(Iterable f(E element)) =>
-      new ExpandIterable<E, dynamic>(this, f);
+  Iterable/*<T>*/ expand/*<T>*/(Iterable/*<T>*/ f(E element)) =>
+      new ExpandIterable<E, dynamic/*=T*/>(this, f);
 
   bool contains(Object element) {
     for (E e in this) {
       if (e == element) return true;
     }
     return false;
   }
 
   void forEach(void f(E element)) {
     for (E element in this) f(element);
   }
 
   E reduce(E combine(E value, E element)) {
     Iterator<E> iterator = this.iterator;
     if (!iterator.moveNext()) {
       throw IterableElementError.noElement();
     }
     E value = iterator.current;
     while (iterator.moveNext()) {
       value = combine(value, iterator.current);
     }
     return value;
   }
 
-  dynamic fold(var initialValue,
-               dynamic combine(var previousValue, E element)) {
+  dynamic/*=T*/ fold/*<T>*/(var/*=T*/ initialValue,
+               dynamic/*=T*/ combine(var/*=T*/ previousValue, E element)) {
     var value = initialValue;
     for (E element in this) value = combine(value, element);
     return value;
   }
 
   bool every(bool f(E element)) {
     for (E element in this) {
       if (!f(element)) return false;
     }
     return true;
@@ skipping 330 matching lines @@
       elision = "...";
       length += ELLIPSIS_SIZE + OVERHEAD;
     }
   }
   if (elision != null) {
     parts.add(elision);
   }
   parts.add(penultimateString);
   parts.add(ultimateString);
 }