RFR: 8302496: Runtime.exit incorrectly says it never throws an exception

[ExE Boss]

On Thu, 27 Apr 2023 23:06:42 GMT, Stuart Marks <smarks at openjdk.org> wrote:

> Textual specification clarifications.

These can use the new generalised `@linkplain` tags available since **JDK 20**:

src/java.base/share/classes/java/lang/Runtime.java line 143:

> 141: 
> 142:     /**
> 143:      * Initiates the <a href="#shutdown">shutdown sequence</a> of the Java Virtual Machine.

Suggestion:

     * Initiates the {@linkplain ##shutdown shutdown sequence} of the Java Virtual Machine.

src/java.base/share/classes/java/lang/Runtime.java line 284:

> 282: 
> 283:     /**
> 284:      * Immediately <a href="#termination">terminates</a> the Java Virtual Machine.

Suggestion:

     * Immediately {@linkplain ##termination terminates} the Java Virtual Machine.

src/java.base/share/classes/java/lang/System.java line 1889:

> 1887: 
> 1888:     /**
> 1889:      * Initiates the <a href="#shutdown">shutdown sequence</a> of the Java Virtual Machine.

Suggestion:

     * Initiates the {@linkplain Runtime##shutdown shutdown sequence} of the Java Virtual Machine.

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

PR Review: https://git.openjdk.org/jdk/pull/13706#pullrequestreview-1405194629
PR Review Comment: https://git.openjdk.org/jdk/pull/13706#discussion_r1179907421
PR Review Comment: https://git.openjdk.org/jdk/pull/13706#discussion_r1179907506
PR Review Comment: https://git.openjdk.org/jdk/pull/13706#discussion_r1179907723