RFR: 8038146: Clarify NavigableMap/TreeMap support for Entry.setValue

[Stuart Marks]

On Fri, 13 Jan 2023 15:04:21 GMT, Alan Bateman <alanb at openjdk.org> wrote:

>> Also additional verbiage regarding Map.Entry objects in general and their possible connection to an underlying Map.
>
> src/java.base/share/classes/java/util/Map.java line 421:
> 
>> 419:      * {@link Set#toArray toArray} overloads,
>> 420:      * or by copying the entry-set view into another collection. It is unspecified whether
>> 421:      * the Entry instances thus obtained are connected to the underlying map, whether
> 
> It might be a bit clearer if tweaked to "whether the obtained Entry instances are connected".

OK. I also tweaked a bit of wording nearby, including changing "extracted" to "obtained" at the start of this paragraph in order to strengthen the connection to this clause.

-------------

PR: https://git.openjdk.org/jdk/pull/11956