On Mon, 10 Nov 2025 20:31:21 GMT, Chen Liang <[email protected]> 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