Reapply "Rename mappedBy to map."

sdk/lib/collection/collections.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 class provides default implementations for Iterables (including Lists).
  *
  * Once Dart receives Mixins it will be replaced with mixin classes.
@@ skipping 295 matching lines @@
         buffer.add("${list[i]}");
       }
     }
     return buffer.toString();
   }
 
   static Iterable where(Iterable iterable, bool f(var element)) {
     return new WhereIterable(iterable, f);
   }
 
+  static Iterable map(Iterable iterable, f(var element)) {
+    return new MappedIterable(iterable, f);
+  }
+
   static List mappedByList(List list, f(var element)) {
+    // This is currently a List as well as an Iterable.
     return new MappedList(list, f);
   }
 
-  static List takeList(List list, int n) {
+  static Iterable takeList(List list, int n) {
     // The generic type is currently lost. It will be fixed with mixins.
+    // This is currently a List as well as an Iterable.
     return new ListView(list, 0, n);
   }
 
   static Iterable takeWhile(Iterable iterable, bool test(var value)) {
     // The generic type is currently lost. It will be fixed with mixins.
     return new TakeWhileIterable(iterable, test);
   }
 
-  static List skipList(List list, int n) {
+  static Iterable skipList(List list, int n) {
     // The generic type is currently lost. It will be fixed with mixins.
+    // This is currently a List as well as an Iterable.
     return new ListView(list, n, null);
   }
 
   static Iterable skipWhile(Iterable iterable, bool test(var value)) {
     // The generic type is currently lost. It will be fixed with mixins.
     return new SkipWhileIterable(iterable, test);
   }
 
   static List reversedList(List l) {
     return new ReversedListView(l, 0, null);
@@ skipping 94 matching lines @@
 
   /** Deprecated. Use the same method in [IterableMixinWorkaround] instead.*/
   static Iterable where(Iterable iterable, bool f(var element))
       => IterableMixinWorkaround.where(iterable, f);
 
   /** Deprecated. Use the same method in [IterableMixinWorkaround] instead.*/
   static List mappedByList(List list, f(var element))
       => IterableMixinWorkaround.mappedByList(list, f);
 
   /** Deprecated. Use the same method in [IterableMixinWorkaround] instead.*/
-  static List takeList(List list, int n)
+  static Iterable takeList(List list, int n)
       => IterableMixinWorkaround.takeList(list, n);
 
   /** Deprecated. Use the same method in [IterableMixinWorkaround] instead.*/
   static Iterable takeWhile(Iterable iterable, bool test(var value))
       => IterableMixinWorkaround.takeWhile(iterable, test);
 
   /** Deprecated. Use the same method in [IterableMixinWorkaround] instead.*/
-  static List skipList(List list, int n)
+  static Iterable skipList(List list, int n)
       => IterableMixinWorkaround.skipList(list, n);
 
   /** Deprecated. Use the same method in [IterableMixinWorkaround] instead.*/
   static Iterable skipWhile(Iterable iterable, bool test(var value))
       => IterableMixinWorkaround.skipWhile(iterable, test);
 
   static String collectionToString(Collection c)
       => ToString.collectionToString(c);
 }