RFR: 8273853: Update the Java manpage for automatic CDS archive updating [v2]

[David Holmes]

On Mon, 6 Jun 2022 20:56:32 GMT, Ioi Lam <iklam at openjdk.org> wrote:

>> Added description of the new flag `-XX:+AutoCreateSharedArchive` to the `java` man page.
>
> Ioi Lam has updated the pull request incrementally with one additional commit since the last revision:
> 
>   @dholmes-ora comments

src/java.base/share/man/java.1 line 5567:

> 5565: the archive at exit.
> 5566: Thus, the archive will be ready to be loaded the next time the JVM is
> 5567: launched with the same command line.

This still seems rather complicated. Suggestion:

> 
> If the specified archive file exists and was created by the same version (release and build number) of the JDK, then it will be loaded as a dynamic archive; otherwise it is ignored at VM startup.
> 
> At VM exit, if the specified archive file does not exist, it will be created. If it exists but was created with a different (but post JDK 19) version of the JDK, then it will be replaced. In both cases the archive will be ready to be loaded the next time the JVM is launched with the same command line.
> 
> If the specified archive file exists but was created by a JDK version prior to JDK 19, then it will be ignored: neither loaded at startup, nor replaced at exit.
>

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

PR: https://git.openjdk.java.net/jdk/pull/9024