On Wed, 2 Apr 2025 13:54:03 GMT, Daniel Fuchs <dfu...@openjdk.org> wrote:

>> David Beaumont has updated the pull request incrementally with one 
>> additional commit since the last revision:
>> 
>>   Reworking user warnings about synchronization and deadlocking based on 
>> Joe's comments.
>
> src/java.logging/share/classes/java/util/logging/Handler.java line 61:
> 
>> 59:  * their {@link #publish(LogRecord)} method, or calls to {@code
>> 60:  * super.publish()}, since these are always expected to need to process 
>> and
>> 61:  * format user-supplied arguments.
> 
> I had to read this paragraph twice to realize it didn't say that subclasses 
> shouldn't call
> super.publish(). What about slightly changing the wording as follows:
> 
> Suggestion:
> 
>  * As such, general purpose {@code Handler} subclasses should not synchronize
>  * their {@link #publish(LogRecord)} method, or call {@code
>  * super.publish()} while holding locks, since these are typically expected 
> to need to process and
>  * format user-supplied arguments.

Done.

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

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

Reply via email to