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

[David Holmes]

On Mon, 8 Aug 2022 02:34:08 GMT, David Holmes <dholmes at openjdk.org> wrote:

>> src/java.base/share/classes/java/lang/Thread.java line 104:
>> 
>>> 102:  * The <a href="Runtime.html#shutdown">shutdown sequence</a> begins when all started
>>> 103:  * non-daemon threads have terminated. Unstarted non-daemon threads do not prevent
>>> 104:  * the shutdown sequence from commencing. Invoking the {@linkplain Runtime#exit(int)}
>> 
>> I think this is the only usage of "commencing", everywhere else uses "beginning" or "begin the shutdown sequence".
>
> "initiated" is also used.

I would suggest saying as little as possible here and simply deferring to the Runtime text ie.:

> The <a href="Runtime.html#shutdown">shutdown sequence</a> begins when all started
non-daemon threads have terminated. 

No need to elaborate, or directly refer to exit().

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

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