RFR: 8348515: Add docs for -XX:AOT* options in java man pages

[Ioi Lam]

On Fri, 24 Jan 2025 17:15:49 GMT, Vladimir Kozlov <kvn at openjdk.org> wrote:

>> I added docs for the following options added by [JEP 483](https://openjdk.org/jeps/483)
>> 
>> - -XX:AOTCache
>> - -XX:AOTClassLinking
>> - -XX:AOTConfiguration
>> - -XX:AOTMode
>> 
>> For a (semi) rendered version, see https://github.com/iklam/jdk/blob/8348515-docs-for-aot-options/src/java.base/share/man/java.md#ahead-of-time-cache
>> 
>> (Some of the rendering by GitHub looks odd, but the java.1 and java.html pages produced by the build should look fine)
>
> src/java.base/share/man/java.md line 4023:
> 
>> 4021: -   A particular application (as expressed by `-classpath`, `-jar`, or `--module-path`.)
>> 4022: -   A particular JDK release.
>> 4023: -   A particular OS and CPU architecture.
> 
> What about VM's flags/settings (GCs for example)?

The impact of flags is duscissed in the "loading of an AOTCache can fail for a number of reasons" section below. Also, I chose not to enumerate all the possible flag incompatibilities, as there's a pretty exhaustive list in [JEP 483](https://openjdk.org/jeps/483).

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

PR Review Comment: https://git.openjdk.org/jdk/pull/23287#discussion_r1929983828