United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
Bug ID: 6269720 (coll spec) Improve documentation of "natural ordering"
6269720 : (coll spec) Improve documentation of "natural ordering"

Details
Type:
Bug
Submit Date:
2005-05-12
Status:
Resolved
Updated Date:
2012-10-08
Project Name:
JDK
Resolved Date:
2005-09-04
Component:
core-libs
OS:
generic
Sub-Component:
java.util:collections
CPU:
generic
Priority:
P4
Resolution:
Fixed
Affected Versions:
6
Fixed Versions:
6

Related Reports
Relates:
JDK-4942830 - (coll spec) TreeSet.remove - absence of Compara{ble,tor} throws ClassCastException

Sub Tasks

Description
The "natural ordering" of elements in some collection is a concept expressed best
in the doc for Comparable, but this is not always obvious to the user of some
collection class that refers to the "natural ordering" concept.
Using {@linkplain Comparable natural ordering} in many places throughout the
Collections framework makes this much clearer.

A number of references to this concept use the phrase "natural order", but
we are using "natural ordering" in a very precise technical sense, so we should
replace all uses of "natural order" with "natural ordering".
###@###.### 2005-05-12 22:48:19 GMT

Comments
EVALUATION

To be fixed as part of the jsr166x project.
###@###.### 2005-05-12 22:49:03 GMT
2005-05-12


Hardware and Software, Engineered to Work Together