List.mappedBy/skip/take returns a List.

sdk/lib/core/list.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.core;
 
 /**
  * A [List] is an indexable collection with a length. It can be of
  * fixed size or extendable.
  */
@@ skipping 180 matching lines @@
    * Throws an [UnsupportedError] if the list is
    * not extendable.
    * If [length] is 0, this method does not do anything.
    * If [start] is the length of the list, this method inserts the
    * range at the end of the list.
    * Throws an [ArgumentError] if [length] is negative.
    * Throws an [RangeError] if [start] is negative or if
    * [start] is greater than the length of the list.
    */
   void insertRange(int start, int length, [E fill]);
+
+  /**
+   * Returns a lazy [List] where each element [:e:] of [this] is replaced
+   * by the result of [:f(e):].

[Lasse Reichstein Nielsen, 2013/01/24 06:49:32]

Mention "unmodifiable" somewhere.

[floitsch, 2013/01/24 13:48:34]

Done.

+   *
+   * This method returns a view of the mapped elements. As long as the
+   * returned [List] is not indexed or iterated over, the supplied function [f]
+   * will not be invoked. The transformed elements will not be cached. Accessing
+   * elements multiple times will invoke the supplied function [f] multiple
+   * times.
+   */
+  List mappedBy(f(E element));
+
+  /**
+   * Returns a [List] that hides the first [n] elements. The returned

[Lasse Reichstein Nielsen, 2013/01/24 06:49:32]

Newlines after '.'.

[floitsch, 2013/01/24 13:48:34]

Done.

+   * list is a view backed by [this].

[Lasse Reichstein Nielsen, 2013/01/24 06:49:32]

[this] -> [:this:]. It's not a declared name.

[floitsch, 2013/01/24 13:48:34]

Done.

+   *
+   * If [this] has fewer than [n] elements, then the resulting [Iterable] will

[Lasse Reichstein Nielsen, 2013/01/24 06:49:32]

If -> While. It can change if the underlying list changes.
[Iterable] -> [List].

[floitsch, 2013/01/24 13:48:34]

Done.

+   * be empty.
+   */
+  List<E> skip(int n);
+
+  /**
+   * Returns a [List] with at most [n] elements. The returned list is a view
+   * backed by this.

[Lasse Reichstein Nielsen, 2013/01/24 06:49:32]

this -> [:this:]  (or "this [List]").

[floitsch, 2013/01/24 13:48:34]

Done.

+   *
+   * The returned [List] may contain fewer than [n] elements, if [this]
+   * contains fewer than [n] elements.
+   */
+  List<E> take(int n);
 }