RFR: 8349206: j.u.l.Handler classes create deadlock risk via synchronized publish() method [v5]

[Roger Riggs]

On Mon, 24 Feb 2025 13:05:57 GMT, David Beaumont <duke at openjdk.org> wrote:

>> You're right, it looks wrong with the `<h2>` and the @implNote. I'll just remove the `<h2>`.
>> I hadn't appreciated that the note would have its own section. Thanks for spotting.
>> It also seems that you can only add one annotation per JavaDoc entry, so I removed the 2nd.
>
> I've asked on the CSR if this should be @implNote or @implSpec.

Those read more like an @ApiNote, advice on how to use the API.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/23491#discussion_r1967859202