diff --git a/src/site/xdoc/migration_3_to_4.xml b/src/site/xdoc/migration_3_to_4.xml deleted file mode 100644 index 05ac5a487..000000000 --- a/src/site/xdoc/migration_3_to_4.xml +++ /dev/null @@ -1,90 +0,0 @@ - - - - - What's new in Commons Collections 4.0? - Commons Documentation Team - - - -
-

Commons Collections 4.0 is out, and the obvious question is: "So what? What's changed?".

-
-

Collections is now Java 5 based. We've generified the API, moved certain APIs to support varargs and thrown out any features -that are now supported by Java itself. We've removed the deprecated parts of the API and have also removed some features that -were deemed weak or unnecessary. All of this means that Collections 4.0 is not backwards compatible.

-

To that end we have changed the package name, allowing Collections 4.0 to sit side-by-side with your previous version of Collections without any bad side effects. -The new package name is the exciting and original org.apache.commons.collections4. This also forces you to recompile your code, making sure the compiler -can let you know if a backwards incompatibility affects you.

-

As you'd expect, there are also new features, enhancements and bugs fixed.

-
-
-

Java code

-

Despite the label of backwards incompatibility, in the vast majority of cases the simple addition of a '4' to an import statement -will suffice for your migration.


-

Change: import org.apache.commons.collections -> import org.apache.commons.collections4

-

Maven

-

groupId: commons-collections -> org.apache.commons

-

artifactId: commons-collections -> commons-collections4

-
- -
-

Buffer package

-

Java 5 introduced a Queue interface which is very similar to a Buffer but offers additional methods, therefore we decided -to replace our existing Buffer implementations with this new interface (unless equivalent classes already exist in the JDK).

-

Previous Deprecations

-

All deprecated fields/methods/classes - with a new major version, all of the previously deprecated parts of the API could finally go away.

-

If you feel that something was unfairly taken away, please feel free to contact the list. In many cases the possibility exists to reintroduce code.

-
-
-

The lone deprecation in 4.0 is for the class "ArrayStack". Java 6 introduced the "java.util.Deque" interface, which supports -LIFO queue implementations, making this class obsolete.

-
-
-

Several new packages have shown up. -

    -
  • org.apache.commons.collections3.queue
    • - collections and decorators for the "java.util.Queue" interface -
  • org.apache.commons.collections3.sequence
    • - provides an implementation to compare two sequences (lists) based on Myers diff algorithm -
  • org.apache.commons.collections3.splitmap
    • - supports Map implementations of Get and Put interfaces with differing generic types -
  • org.apache.commons.collections3.trie
    • - TODO -
-

-
-
-

There are many new classes and methods in Collections 4.0 - the most complete way to see the changes is via this -Collections3 to Collections4 Clirr report.

-

Here is a summary of the new classes:

-
    -
  • TBD
    • -
-
- -
-

See the 4.0 changes report for the list of fixed bugs and other enhancements.

-
- -
-
    -
  • TBD
    • -
-
- -
- - - diff --git a/src/site/xdoc/release_4_0.xml b/src/site/xdoc/release_4_0.xml deleted file mode 100644 index f548b5e90..000000000 --- a/src/site/xdoc/release_4_0.xml +++ /dev/null @@ -1,111 +0,0 @@ - - - - - Release notes for v4.0 - Commons Documentation Team - - - -
-

-Commons collections is a project to develop and maintain collection classes -based on and inspired by the JDK collection framework. -This project is JDK1.5+ compatible and supports generics. -

-

-This release adds various new classes and fixes a number of bugs. -All feedback should be directed to commons-user at jakarta.apache.org. -

-
- -

COMPATIBILITY

-

-This release is not source or binary compatible with v3.x. -

-

-One bug was that the ExtendedProperties was hiding properties with empty -property values. It is possible you could have been depending on that feature. -See [COLLECTIONS-238]. -

-

-There are is one new deprecation:
-

-If this causes major headaches to anyone please contact dev at commons.apache.org. -

- -

NEW CLASSES

- - -

ENHANCEMENTS

- - -

BUG FIXES

- - -

JAVADOC

- -
- - -