RFR: 8343840: Rewrite the ObjectMonitor lists [v2]

[Fredrik Bredberg]

On Thu, 27 Feb 2025 13:59:38 GMT, Coleen Phillimore <coleenp at openjdk.org> wrote:

>> src/hotspot/share/runtime/objectMonitor.cpp line 166:
>> 
>>> 164: //   its next pointer, and have its prev pointer set to null. Thus
>>> 165: //   pushing six threads A-F (in that order) onto entry_list, will
>>> 166: //   form a singly-linked list, see 1) below.
>> 
>> Suggestion: have diagram 1 immediately follow this text so the reader doesn't have to jump down.
>
> I like this suggestion.  I like these comments.

Fixed

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

PR Review Comment: https://git.openjdk.org/jdk/pull/23421#discussion_r1974247465