RFR: 8295857: Clarify that cleanup code can be skipped when the JVM terminates (e.g. when calling halt()) [v7]

[Stuart Marks]

On Wed, 7 Dec 2022 17:38:31 GMT, Brent Christian <bchristi at openjdk.org> wrote:

>> [JDK-8290036](https://bugs.openjdk.org/browse/JDK-8290036) documented the shutdown sequence, noting that calling Runtime.halt() skips the shutdown sequence and immediately terminates the VM. Thus, "threads' current methods do not complete normally or abruptly; no finally clause of any method is executed".
>> 
>> One ramification of this is that resources within try-with-resource blocks will not be released. It would be good to state this explicitly.
>
> Brent Christian has updated the pull request with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains 10 additional commits since the last revision:
> 
>  - Merge branch 'master' into 8295857
>  - 'close' -> 'closed' in AutoCloseable link
>  - put examples into a list, in class doc only, not halt()
>  - Update Runtime class doc re: other unexpected behaviors
>  - Mentioned effects are not a complete list
>  - It's "try-with-resources"
>  - Merge branch 'master' into 8295857
>  - update halt() @apiNote
>  - update doc changes
>  - Update doc for Runtime class and halt() method

Looks good!

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

Marked as reviewed by smarks (Reviewer).

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