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

[William Kemper]

On Wed, 17 Jan 2024 16:49:02 GMT, Kelvin Nilsen <kdnilsen at openjdk.org> wrote:

>> 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:
> 
>   Add clarification to multiple comments

Thank you for doing this. Spotted a minor typo, otherwise looks great!

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

Marked as reviewed by wkemper (Author).

PR Review: https://git.openjdk.org/jdk/pull/17385#pullrequestreview-1827920714