Implement removeRange, and update some documentation on the list interface.

tests/corelib/src/ListRemoveRangeTest.dart

Index: tests/corelib/src/ListRemoveRangeTest.dart
===================================================================
--- tests/corelib/src/ListRemoveRangeTest.dart	(revision 0)
+++ tests/corelib/src/ListRemoveRangeTest.dart	(revision 0)
@@ -0,0 +1,66 @@
+// Copyright (c) 2011, 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.
+
+main() {
+  var list = [];
+  list.removeRange(0, 0);
+  Expect.equals(0, list.length);
+  expectIOORE(() { list.removeRange(0, 1); });
+
+  list.add(1);
+  list.removeRange(0, 0);
+  Expect.equals(1, list.length);
+  Expect.equals(1, list[0]);
+
+  expectIOORE(() { list.removeRange(0, 2); });
+  Expect.equals(1, list.length);
+  Expect.equals(1, list[0]);
+
+  list.removeRange(0, 1);
+  Expect.equals(0, list.length);
+
+  list.addAll([3, 4, 5, 6]);
+  Expect.equals(4, list.length);
+  list.removeRange(0, 4);
+  Expect.listEquals([], list);
+
+  list.addAll([3, 4, 5, 6]);
+  list.removeRange(2, 2);
+  Expect.listEquals([3, 4], list);
+  list.addAll([5, 6]);
+
+  expectIOORE(() { list.removeRange(4, 1); });
+  Expect.listEquals([3, 4, 5, 6], list);
+
+  list.removeRange(1, 2);
+  Expect.listEquals([3, 6], list);
+
+  testNegativeIndices();
+}
+
+void expectIOORE(Function f) {
+  Expect.throws(f, (e) => e is IndexOutOfRangeException);
+}
+
+void testNegativeIndices() {
+  var list = [1, 2];
+  expectIOORE(() { list.removeRange(-1, 1); });
+  Expect.listEquals([1, 2], list);
+
+  // A negative length throws an IllegalArgumentException.
+  Expect.throws(() { list.removeRange(0, -1); },
+      (e) => e is IllegalArgumentException);
+  Expect.listEquals([1, 2], list);
+
+  Expect.throws(() { list.removeRange(-1, -1); },
+      (e) => e is IllegalArgumentException);
+  Expect.listEquals([1, 2], list);
+
+  // A zero length prevails, and does not throw an exception.
+  list.removeRange(-1, 0);
+  Expect.listEquals([1, 2], list);
+
+  list.removeRange(4, 0);
+  Expect.listEquals([1, 2], list);
+}