[jdk18] RFR: 8278607: Misc issues in foreign API javadoc [v2]

[Maurizio Cimadamore]

> This patch fixes a number of issues and typos in the foreign API javadoc following another internal round of reviews.

Maurizio Cimadamore has updated the pull request incrementally with one additional commit since the last revision:

  Fix capitalization in package-info

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

Changes:
  - all: https://git.openjdk.java.net/jdk18/pull/17/files
  - new: https://git.openjdk.java.net/jdk18/pull/17/files/011f6e5f..aa74d836

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

  Stats: 1 line in 1 file changed: 0 ins; 0 del; 1 mod
  Patch: https://git.openjdk.java.net/jdk18/pull/17.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk18 pull/17/head:pull/17

PR: https://git.openjdk.java.net/jdk18/pull/17