RFR: 8287748: Fix issues in java.lang.foreign package javadoc

[Jorn Vernee]

On Thu, 2 Jun 2022 20:41:39 GMT, Maurizio Cimadamore <mcimadamore at openjdk.org> wrote:

> This patch fixes a couple of issues in the package-level javadoc of the foreign API.
> I've also dropped uses of `var`, which I think are confusing so early in the game.

Marked as reviewed by jvernee (Reviewer).

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

PR: https://git.openjdk.java.net/jdk/pull/9005