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

[Vladimir Kozlov]

On Fri, 24 Jan 2025 01:49:19 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)

I am not sure if there is rule about ordering flags description alphabetically. 
I would exactly reverse the order you have to put more important flags first.

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)?

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

PR Review: https://git.openjdk.org/jdk/pull/23287#pullrequestreview-2573194719
PR Review Comment: https://git.openjdk.org/jdk/pull/23287#discussion_r1929006393