RFR (14) 8236769: Clarify javadoc of memory access API

[Chris Hegarty]

Maurizio,

> On 8 Jan 2020, at 12:36, Maurizio Cimadamore <maurizio.cimadamore at oracle.com> wrote:
> 
> A link to the webrev might be useful I guess :-)
> 
> http://cr.openjdk.java.net/~mcimadamore/8236769/

Mostly looks good.

Trivially, regarding the use of implSpec in MemoryLayout; I think that the tag is just not needed, right? The statement is normative.  Though I have to admit to being confused on occasion as to the difference between some of these tags, see draft JEP [1] ). I think that implSpec could be argued for byteAlighment, since that method provides a default implementation, then again maybe the new no-explicit natural-ordering wording is still spec, and an implSpec could be added to cover the actual default implementation?

-Chris.

[1] https://openjdk.java.net/jeps/8068562