RFR: 8323634: Shenandoah: Document behavior of EvacOOM protocol [v5]

[Kelvin Nilsen]

> The protocol for handling OOM during evacuation is subtle and critical for correct operation.  This PR does NOT change behavior.  It provided improved documentation of existing behavior.

Kelvin Nilsen has updated the pull request incrementally with one additional commit since the last revision:

  Fix spelling error and mismatched parentheses.

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/17385/files
  - new: https://git.openjdk.org/jdk/pull/17385/files/d1d1c1c6..6017ea1c

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=17385&range=04
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=17385&range=03-04

  Stats: 2 lines in 1 file changed: 0 ins; 0 del; 2 mod
  Patch: https://git.openjdk.org/jdk/pull/17385.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/17385/head:pull/17385

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