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

[Aleksey Shipilev]

On Wed, 24 Jan 2024 17:53:39 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 provides 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.

Hm, I expected that "Document behavior" would only change comments, but I also see code additions. Let me look at the whole thing. I think I have a few editorial comments as well, I'll just give a patch on top of this PR.

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

PR Comment: https://git.openjdk.org/jdk/pull/17385#issuecomment-1944059758