Deprecate LinkedList.

sdk/lib/collection/linked_list.dart

 // Copyright (c) 2013, 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 "collection.dart";
 
 /**
  * A specialized double-linked list of elements that extends [LinkedListEntry].
  *
+ * Deprecated. Use the same named class from package `collection`, instead.
+ * [https://pub.dartlang.org/packages/collection]
+ *
  * This is not a generic data structure. It only accepts elements that extend
  * the [LinkedListEntry] class. See the [Queue] implementations for
  * generic collections that allow constant time adding and removing at the ends.
  *
  * This is not a [List] implementation. Despite its name, this class does not
  * implement the [List] interface. It does not allow constant time lookup by
  * index.
  *
  * Because the elements themselves contain the links of this linked list,
  * each element can be in only one list at a time. To add an element to another
  * list, it must first be removed from its current list (if any).
  *
  * In return, each element knows its own place in the linked list, as well as
  * which list it is in. This allows constant time [LinkedListEntry.insertAfter],
  * [LinkedListEntry.insertBefore] and [LinkedListEntry.unlink] operations
  * when all you have is the element.
  *
  * A `LinkedList` also allows constant time adding and removing at either end,
  * and a constant time length getter.
  */
+@deprecated
 class LinkedList<E extends LinkedListEntry<E>> extends Iterable<E> {
   int _modificationCount = 0;
   int _length = 0;
   E _first;
 
   /**
    * Construct a new empty linked list.
    */
   LinkedList();
 
@@ skipping 170 matching lines @@
     _visitedFirst = true;
     _current = _next;
     _next = _next._next;
     return true;
   }
 }
 
 /**
  * An object that can be an element in a [LinkedList].
  *
+ * Deprecated. Use the same named class from package `collection`, instead.
+ * [https://pub.dartlang.org/packages/collection]
+ *
  * All elements of a `LinkedList` must extend this class.
  * The class provides the internal links that link elements together
  * in the `LinkedList`, and a reference to the linked list itself
  * that an element is currently part of.
  *
  * An entry can be in at most one linked list at a time.
  * While an entry is in a linked list, the [list] property points to that
  * linked list, and otherwise the `list` property is `null`.
  *
  * When created, an entry is not in any linked list.
  */
+@deprecated
 abstract class LinkedListEntry<E extends LinkedListEntry<E>> {
   LinkedList<E> _list;
   E _next;
   E _previous;
 
   /**
    * Get the linked list containing this element.
    *
    * Returns `null` if this entry is not currently in any list.
    */
@@ skipping 43 matching lines @@
   /**
    * Insert an element before this element in this element's linked list.
    *
    * This entry must be in a linked list when this method is called.
    * The [entry] must not be in a linked list.
    */
   void insertBefore(E entry) {
     _list._insertBefore(this as dynamic/*=E*/, entry, updateFirst: true);
   }
 }