archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-28 07:14:30 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

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

Browse source 
Reviewed-by: alanb
This commit is contained in:
Stuart Marks 2023-05-02 23:19:30 +00:00
parent 8a70664e52
commit 05b9b5821d
2 changed files with 30 additions and 26 deletions
Download patch file Download diff file Expand all files Collapse all files

18
src/java.base/share/classes/java/lang/System.java
View file

@ -1886,18 +1886,18 @@ public final class System {
}
/**
* Initiates the <a href="Runtime.html#shutdown">shutdown sequence</a> of the
* Java Virtual Machine. This method always blocks indefinitely. The argument
* serves as a status code; by convention, a nonzero status code indicates
* abnormal termination.
* Initiates the {@linkplain Runtime##shutdown shutdown sequence} of the Java Virtual Machine.
* Unless the security manager denies exiting, this method initiates the shutdown sequence
* (if it is not already initiated) and then blocks indefinitely. This method neither returns
* nor throws an exception; that is, it does not complete either normally or abruptly.
* <p>
* This method calls the {@code exit} method in class {@code Runtime}. This
* method never returns normally.
* The argument serves as a status code. By convention, a nonzero status code
* indicates abnormal termination.
* <p>
* The call {@code System.exit(n)} is effectively equivalent to the call:
* <blockquote><pre>
* Runtime.getRuntime().exit(n)
* </pre></blockquote>
* {@snippet :
* Runtime.getRuntime().exit(n)
* }
*
* @implNote
* The initiation of the shutdown sequence is logged by {@link Runtime#exit(int)}.