RFR: 8371226: Thread class description needs section on Thread Interruption

[Alan Bateman]

On Mon, 10 Nov 2025 20:31:21 GMT, Chen Liang <liach at openjdk.org> wrote:

>> This is docs only change to a new section to the Thread class description on Thread Interruption.  The new section provides guidance on handling InterruptedException. A subset of that guidance is also proposed for the InterruptedException class description.
>
> src/java.base/share/classes/java/lang/Thread.java line 244:
> 
>> 242:  * </table>
>> 243:  * <p> The virtual thread scheduler can be monitored and managed with the
>> 244:  * {@link jdk.management/jdk.management.VirtualThreadSchedulerMXBean} management
> 
> Links to jdk. modules will break the Java SE API doc from `make docs-javase` when it runs the jdkCheckLinks test. We may have to use `{@code}` instead.

Thanks. It's not an issue for the "docs" target as that includes the JDK-specific modules so that implNotes can cross link to JDK-specific modules. But you are right that "docs-javase" (used for JCP submissions) can't link to non-standard modules.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/28216#discussion_r2513062205