RFR: 8290036: Define and specify Runtime shutdown sequence [v7]

[David Holmes]

On Fri, 26 Aug 2022 23:15:42 GMT, Stuart Marks <smarks at openjdk.org> wrote:

>> The concept of the shutdown sequence needs to be specified more clearly. This PR adds text for this into the class specification of `java.lang.Runtime`. Also includes adjustments to related areas in `addShutdownHook`, `halt`, and in the `System` and `Thread` classes. The changes here should coordinate with similar changes to JLS 12.8, JVMS 5.7, and the Invocation API chapter of the _JNI Specification._
>
> Stuart Marks has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Minor adjustments

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

> 63:  * <p>In contrast to {@link #exit exit}, the {@link #halt halt} method does not initiate the
> 64:  * shutdown sequence. See the <a href="#termination">Java Virtual Machine Termination</a> section
> 65:  * below.

The forward ref seems inappropriate when this is the section describing which events trigger the shutdown sequence.

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

PR: https://git.openjdk.org/jdk/pull/9437