~ubuntu-branches/ubuntu/oneiric/libcommons-collections-java/oneiric

« back to all changes in this revision

Viewing changes to RELEASE-NOTES-2.1.1.html

  • Committer: Bazaar Package Importer
  • Author(s): Takashi Okamoto
  • Date: 2004-08-07 00:02:50 UTC
  • Revision ID: james.westby@ubuntu.com-20040807000250-hcnqvrdpxg95nmzr
Tags: upstream-2.1.1
ImportĀ upstreamĀ versionĀ 2.1.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<title>RELEASE NOTES: COLLECTIONS 2.1.1</title>
 
2
 
 
3
<center><h2>RELEASE NOTES: COLLECTIONS 2.1.1</h2></center>
 
4
 
 
5
<p>
 
6
<b>This is a patch release of Commons Collections 2.1</b>
 
7
</p>
 
8
<p>
 
9
The latest version of Commons Collections is 3.0.
 
10
Unfortunately, the release of version 3.0 introduced a binary incompatibility
 
11
with 2.1 in the <code>IteratorUtils</code> class. We apologise for this error.
 
12
</p>
 
13
<p>
 
14
Regrettably, despite the issue being discovered by other teams, no feedback was
 
15
given to the Commons Collections team, preventing a simple solution.
 
16
<i>Please provide feedback to Commons Collections when you find issues like this!</i>
 
17
</p>
 
18
<p>
 
19
This patch to Commons Collections is designed to allow version 2.1.1 to co-exist
 
20
with version 3.1. The patch contains the following changes:
 
21
<ul>
 
22
<li>Deprecated <code>IteratorUtils.arrayIterator(...)</code> -
 
23
     use <code>new ArrayIterator(...)</code> instead</li>
 
24
<li>Deprecated <code>IteratorUtils.singletonIterator(...)</code> -
 
25
     use <code>new SingletonIterator(...)</code> instead</li>
 
26
<li>Deprecated <code>IteratorUtils.emptyIterator()</code> -
 
27
     use <code>EmptyIterator.INSTANCE</code> instead</li>
 
28
<li>Deprecated <code>IteratorUtils.emptyListIterator()</code> -
 
29
     use <code>EmptyListIterator.INSTANCE</code> instead</li>
 
30
<li>Deprecated <code>IteratorUtils.EMPTY_ITERATOR</code> -
 
31
     use <code>EmptyIterator.INSTANCE</code> instead</li>
 
32
<li>Deprecated <code>IteratorUtils.EMPTY_LIST_ITERATOR</code> -
 
33
     use <code>EmptyIterator.INSTANCE</code> instead</li>
 
34
<li>Added <code>EmptyIterator</code></li>
 
35
<li>Added <code>EmptyListIterator</code></li>
 
36
<li>Renamed enum variables to enumeration to enable compilation on JDK1.5</li>
 
37
<li>Switched to Apache License 2.0</li>
 
38
</ul>
 
39
</p>
 
40
<p>
 
41
To make your code compatible with both 2.1.1 and 3.1 and later, remove all
 
42
deprecation warnings from your code and re-release.
 
43
If you have no deprecation warnings after installing this jar, your code is
 
44
already compatible, and will run with versions 2.1, 2.1.1, 3.0 and later.
 
45
</p>