--- jsr166/src/main/java/util/Vector.java 2005/12/05 02:56:59 1.7 +++ jsr166/src/main/java/util/Vector.java 2006/03/19 17:59:39 1.9 @@ -6,29 +6,24 @@ */ package java.util; -import java.util.*; // for javadoc (till 6280605 is fixed) /** * The Vector class implements a growable array of * objects. Like an array, it contains components that can be * accessed using an integer index. However, the size of a * Vector can grow or shrink as needed to accommodate - * adding and removing items after the Vector has been created.

+ * adding and removing items after the Vector has been created. * - * Each vector tries to optimize storage management by maintaining a + *

Each vector tries to optimize storage management by maintaining a * capacity and a capacityIncrement. The * capacity is always at least as large as the vector * size; it is usually larger because as components are added to the * vector, the vector's storage increases in chunks the size of * capacityIncrement. An application can increase the * capacity of a vector before inserting a large number of - * components; this reduces the amount of incremental reallocation.

+ * components; this reduces the amount of incremental reallocation. * - * As of the Java 2 platform v1.2, this class has been retrofitted to - * implement List, so that it becomes a part of Java's collection framework. - * Unlike the new collection implementations, Vector is synchronized.

- * - * The Iterators returned by Vector's iterator and listIterator + *

The Iterators returned by Vector's iterator and listIterator * methods are fail-fast: if the Vector is structurally modified * at any time after the Iterator is created, in any way except through the * Iterator's own remove or add methods, the Iterator will throw a @@ -44,11 +39,13 @@ import java.util.*; // for javadoc (till * throw ConcurrentModificationException on a best-effort basis. * Therefore, it would be wrong to write a program that depended on this * exception for its correctness: the fail-fast behavior of iterators - * should be used only to detect bugs.

+ * should be used only to detect bugs. * - * This class is a member of the - * - * Java Collections Framework. + *

As of the Java 2 platform v1.2, this class was retrofitted to + * implement the {@link List} interface, making it a member of the + * Java + * Collections Framework. Unlike the new collection + * implementations, {@code Vector} is synchronized. * * @author Lee Boynton * @author Jonathan Payne