man pages are out of date

**What are you trying to do?**

Learn the options available for the JVM.

**Expected behaviour:**

`man java` (or `man -l man/man1/java.1`) shows me documentation corresponding to the program in `bin/java`, including information about the JVM in this distribution.

**Observed behaviour:**

`man -l man/man1/java.1` in a recent build of temurin-11 shows me documentation for some build of JDK 8 in 2015.

Start by inspecting man/man1/java.1 and the bin/java program in a recent temurin-11 build, then compare the man page with the options and JVM information exposed by that program. Done means `man java` or `man -l man/man1/java.1` documents the corresponding distribution rather than an older JDK 8 build.

Written by the indexing model from the issue text.