Name: boT120536 Date: 01/11/2001


java version "1.3.0"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.0-RC)
Java HotSpot(TM) Client VM (build 1.3.0-RC, mixed mode)


The Bug 4098033 was set as "Closed will not be fixed" with the following comment

"An alternative proposal was to add a new interface java.lang.Publicly
Cloneable to reflect the original intended purpose of Cloneable. By a 5 to 2
majority, TRC recommended against this. The main concern was that this would
add yet more confusion (including spelling confusion!) to an already confused
picture.
TRC unanimously recommended that we should add additional
documentation to the existing Cloneable interface to better
describe how it is intended to be used and to describe
'best practices' for implementors."


The documentation addition has still not been done and the bug was flagged as
closed (as a side effect people can not vote for it in the bug parade...)

Please add documentation about how to clone collection objects, how to properly
implement a public clone() method to make your objects cloneable.

Please also describe how new interfaces being developped for copiable objects
should be designed (should they include a public clone() method) to support a
polymorphic clone feature.


Please keep Java a simple and convenient language. This issue is really annoying
for non-beginner Java developpers, I can imagine it's a nighmare and a
"Java-repellent" for novice Java developpers.
(Review ID: 114900)
======================================================================