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

[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:

  Clarify sentence in package-info

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

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

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

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