8038146: Clarify Map.Entry's connection to the underlying map

Reviewed-by: alanb
This commit is contained in:
Stuart Marks 2023-01-20 16:33:48 +00:00
parent b2d3622115
commit c6d5600396
4 changed files with 74 additions and 36 deletions

View file

@ -590,7 +590,8 @@ public abstract class AbstractMap<K,V> implements Map<K,V> {
/**
* An Entry maintaining a key and a value. The value may be
* changed using the {@code setValue} method. Instances of
* this class are not associated with any map's entry-set view.
* this class are not associated with any map nor with any
* map's entry-set view.
*
* @apiNote
* This class facilitates the process of building custom map
@ -730,7 +731,8 @@ public abstract class AbstractMap<K,V> implements Map<K,V> {
/**
* An unmodifiable Entry maintaining a key and a value. This class
* does not support the {@code setValue} method. Instances of
* this class are not associated with any map's entry-set view.
* this class are not associated with any map nor with any map's
* entry-set view.
*
* @apiNote
* Instances of this class are not necessarily immutable, as the key