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

src/hotspot/share/gc/shenandoah/shenandoahEvacOOMHandler.hpp line 71:

> 69:  *  1. If we fail to evacuate the entirety of live memory from all cset regions,
> 70:  *     we will transition first to degenerated GC and if that fails, to full GC at
> 71:  *     the end of this canceeled concurrent evacuation phase.  To heal heap invariants

s/canceeled/cancelled

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

PR Review Comment: https://git.openjdk.org/jdk/pull/17385#discussion_r1456253873