[foreign-abi] RFR: Misc javadoc fixes [v2]

[Maurizio Cimadamore]

> I did another pass on the ABI-related javadoc; this resulted in a biggie surgery of the javadoc in `CLinker` as well as
> few minor changes/fixes in several places.

Maurizio Cimadamore has updated the pull request incrementally with four additional commits since the last revision:

 - Merge branch 'abi-javadoc-fixes' of https://github.com/mcimadamore/panama-foreign into abi-javadoc-fixes
 - Update src/jdk.incubator.foreign/share/classes/jdk/incubator/foreign/CLinker.java
   
   Co-authored-by: Jorn Vernee <JornVernee at users.noreply.github.com>
 - Update src/jdk.incubator.foreign/share/classes/jdk/incubator/foreign/CLinker.java
   
   Co-authored-by: Jorn Vernee <JornVernee at users.noreply.github.com>
 - Address review comments

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

Changes:
  - all: https://git.openjdk.java.net/panama-foreign/pull/373/files
  - new: https://git.openjdk.java.net/panama-foreign/pull/373/files/cbb05170..bb2bb4a0

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

  Stats: 3 lines in 1 file changed: 0 ins; 0 del; 3 mod
  Patch: https://git.openjdk.java.net/panama-foreign/pull/373.diff
  Fetch: git fetch https://git.openjdk.java.net/panama-foreign pull/373/head:pull/373

PR: https://git.openjdk.java.net/panama-foreign/pull/373