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

[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

David Holmes has updated the pull request incrementally with one additional commit since the last revision:

  Fix name case in jfieldID and jmethodID

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

Changes:
  - all: https://git.openjdk.java.net/jdk17/pull/52/files
  - new: https://git.openjdk.java.net/jdk17/pull/52/files/7031dc97..bf28b057

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=jdk17&pr=52&range=01
 - incr: https://webrevs.openjdk.java.net/?repo=jdk17&pr=52&range=00-01

  Stats: 1 line in 1 file changed: 0 ins; 0 del; 1 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