anchor.diff:   * The following code illustrates that some List implementations support
    * only a subset of the API.
    *
  - *     var fixedLengthList = new List(5);
  - *     fixedLengthList.length = 0;  // Error.
  - *     fixedLengthList.add(499);    // Error.
  + *     List<int> fixedLengthList = new List(5);
  + *     fixedLengthList.length = 0;  // Error
  + *     fixedLengthList.add(499);    // Error
    *     fixedLengthList[0] = 87;
  - *
  - *     var growableList = [1, 2];
  + *     List<int> growableList = [1, 2];
    *     growableList.length = 0;
    *     growableList.add(499);
    *     growableList[0] = 87;
    *
  - * Lists are [Iterable].
  - * Iteration occurs over values in index order.
  - * Changing the values does not affect iteration,
  - * but changing the valid indices&mdash;that is,
  - * changing the list's length&mdash;between
  - * iteration steps
  - * causes a [ConcurrentModificationError].
  - * This means that only growable lists can throw ConcurrentModificationError.
  - * If the length changes temporarily
  - * and is restored before continuing the iteration,
  - * the iterator does not detect it.
  + * Lists are [Iterable]. Iteration occurs over values in index order. Changing
  + * the values does not affect iteration, but changing the valid
  + * indices&mdash;that is, changing the list's length&mdash;between iteration
  + * steps causes a [ConcurrentModificationError]. This means that only growable
  + * lists can throw ConcurrentModificationError. If the length changes
  + * temporarily and is restored before continuing the iteration, the iterator
  + * does not detect it.
    */
   abstract class List<E> implements Iterable<E> {
     /**
  -   * Creates a list of the given _length_.
  -   *
  -   * The created list is fixed-length if _length_ is provided.
  -   * The list has length 0 and is growable if _length_ is omitted.
  -   *
  -   * An error occurs if _length_ is negative.
  +   * Creates a list of the given length.
  +   *
  +   * The created list is fixed-length if [length] is provided.
  +   *
  +   *     List fixedLengthList = new List(3);
  +   *     fixedLengthList.length;     // 3
  +         fixedLengthList.length = 1; // Error
  +   *
  +   *
  +   * The list has length 0 and is growable if [length] is omitted.
  +   *
  +   *     List growableList = new List();
  +   *     growableList.length; // 0;
  +   *     growableList.length = 3;
  +   *
  +   * An error occurs if [length] is negative.
      */
     external factory List([int length]);
   
     /**
  -   * Creates a fixed-length list of the given _length_
  -   * and initializes the value at each position with [fill].
  +   * Creates a fixed-length list of the given length, and initializes the
  +   * value at each position with [fill]:
  +   *
  +   *     new List<int>.filled(3, 0); // [0, 0, 0]
      */
     external factory List.filled(int length, E fill);
   
  
positive.code:    *
     * An object [:o:] satisfies [test] if [:test(o):] is true.
     *
     * Throws an [UnsupportedError] if this is a fixed-length list.
     */
    void removeWhere(bool test(E element));
  
negative.code:    * The map uses the indices of this list as keys and the corresponding objects
     * as values. The `Map.keys` [Iterable] iterates the indices of this list
     * in numerical order.
     *
     *     List<String> words = ['fee', 'fi', 'fo', 'fum'];
     *     Map<int, String> map = words.asMap();
     *     map[0] + map[1];   // 'feefi';
     *     map.keys.toList(); // [0, 1, 2, 3]
     */
    Map<int, E> asMap();
  }
  