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

[John Rose]

Nice work.  I like this API a lot, and the doc is getting a good clear 
shine on it.

The run-on sentence at the top of `<h3>Foreign addresses</h3>` needs a 
bit more polish.  The long parenthetical comment still reads awkwardly.  
Maybe it doesn’t need parentheses any more, now that it’s part of 
(or all of) its own small sentence?

On 13 Dec 2021, at 13:20, Maurizio Cimadamore wrote:

> This patch fixes a number of issues and typos in the foreign API 
> javadoc following another internal round of reviews.
>
> -------------
>
> Commit messages:
>  - Misc foreign API javadoc fixes
>
> Changes: https://git.openjdk.java.net/jdk18/pull/17/files
>  Webrev: https://webrevs.openjdk.java.net/?repo=jdk18&pr=17&range=00
>   Issue: https://bugs.openjdk.java.net/browse/JDK-8278607
>   Stats: 35 lines in 7 files changed: 3 ins; 1 del; 31 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