RFR: 8247402: Documentation for Map::compute contains confusing implementation requirements [v2]

[John Lin]

> This is from the mailing list: http://mail.openjdk.java.net/pipermail/core-libs-dev/2020-June/067190.html
> 
> ---------
> ### Progress
> - [x] Change must not contain extraneous whitespace
> - [x] Commit message must refer to an issue
> - [ ] Change must be properly reviewed
> 
> ### Testing
> 
> |     | Linux x64 | Windows x64 | macOS x64 |
> | --- | ----- | ----- | ----- |
> | Build | ✔️ (5/5 passed) | ✔️ (2/2 passed) | ✔️ (2/2 passed) |
> | Test (tier1) | ✔️ (9/9 passed) | ✔️ (9/9 passed) | ✔️ (9/9 passed) |
> 
> 
> 
> ### Download
> `$ git fetch https://git.openjdk.java.net/jdk pull/714/head:pull/714`
> `$ git checkout pull/714`

John Lin has updated the pull request with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains one additional commit since the last revision:

  8247402: Documentation for Map::compute contains confusing implementation requirements

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

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/714/files
  - new: https://git.openjdk.java.net/jdk/pull/714/files/d058e798..d16a35b8

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=jdk&pr=714&range=01
 - incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=714&range=00-01

  Stats: 394209 lines in 3620 files changed: 249166 ins; 107447 del; 37596 mod
  Patch: https://git.openjdk.java.net/jdk/pull/714.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/714/head:pull/714

PR: https://git.openjdk.java.net/jdk/pull/714