[foreign-preview] RFR: 8282805: Javadoc for restricted method does not reflect updates to --enable-native-access [v2]

[Maurizio Cimadamore]

> This simple patch updates the javadoc comments for restricted methods to reflect the updated behavior of the `--enable-native-access` flag.
> All the `@throws` tags in restricted methods are updated, as well as the toplevel package javadoc section on restricted methods.

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

  Address review comments

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

Changes:
  - all: https://git.openjdk.java.net/panama-foreign/pull/665/files
  - new: https://git.openjdk.java.net/panama-foreign/pull/665/files/324db9c1..f8cecb65

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

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

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