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

[John R Rose]

On Mon, 27 Jan 2025 16:58:44 GMT, Ioi Lam <iklam 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)
>
> Ioi Lam has updated the pull request incrementally with one additional commit since the last revision:
> 
>   @adinn comment - fixed typo

src/java.base/share/man/java.md line 4017:

> 4015: storing artifacts produced by AOT optimizations. The AOTCache currently contains
> 4016: Java classes and heap objects. The plans is to include other types of artifacts,
> 4017: such as execution profiles and compiled methods, in future JDK releases.

s/plans/plan/ or reframe the sentence as:

> In future JDK releases, the AOT cache may contain additional artifacts, such as execution profiles and compiled methods.

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

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