[jdk17] RFR: 8260194: Update the documentation for -Xcheck:jni

[David Holmes]

Please review this update to the -Xcheck:jni description in the java manpage.

For ease of reading there was a temporary commit of the generated java.html page. This can be viewed here:

https://htmlpreview.github.io/?https://github.com/openjdk/jdk17/blob/4f336dd3985b654dc3fbacabdcfccf590ea918e5/java.html

A preemptive note on the punctuation of the lists. The  first and second level level list items are all complete sentences and so end with a period. The third level list items are phrases, not full sentences and so do not end with a period. :)

Thanks,
David

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

Commit messages:
 - Remove java.html again
 - Temporary commit of java.html for ease of reading the changes.
 - 8260194: Update the documentation for -Xcheck:jni

Changes: https://git.openjdk.java.net/jdk17/pull/52/files
 Webrev: https://webrevs.openjdk.java.net/?repo=jdk17&pr=52&range=00
  Issue: https://bugs.openjdk.java.net/browse/JDK-8260194
  Stats: 68 lines in 1 file changed: 62 ins; 6 del; 0 mod
  Patch: https://git.openjdk.java.net/jdk17/pull/52.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk17 pull/52/head:pull/52

PR: https://git.openjdk.java.net/jdk17/pull/52