[foreign-memaccess] Tweaks to JavaDoc

[Paul Sandoz]

Hi,

Here are some suggested tweaks to the JavaDoc.

http://cr.openjdk.java.net/~psandoz/panama/foreign-memaccess-javadoc/webrev/ <http://cr.openjdk.java.net/~psandoz/panama/foreign-memaccess-javadoc/webrev/>

—

Some observations:

- IllegalArgumentException is used to indicate out of bounds exceptions rather than IndexOutOfBoundsException

- RuntimeException is occasionally used e.g. "specified size is too large for the system runtime"

- Layout classes state:

* @implSpec
* This class is immutable and thread-safe.

This seems to be more of a spec requirement than an implementation detail.

Paul.