--- old/src/share/classes/java/util/WeakHashMap.java 2012-05-28 14:07:40.610546721 +0800 +++ new/src/share/classes/java/util/WeakHashMap.java 2012-05-28 14:07:40.310545228 +0800 @@ -90,7 +90,8 @@ * from being discarded. Note that a value object may refer indirectly to its * key via the WeakHashMap itself; that is, a value object may * strongly refer to some other key object whose associated value object, in - * turn, strongly refers to the key of the first value object. One way + * turn, strongly refers to the key of the first value object. If the values + * in the map do not rely on the map holding strong references to them, one way * to deal with this is to wrap values themselves within * WeakReferences before * inserting, as in: m.put(key, new WeakReference(value)),