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

[Maurizio Cimadamore]

I've looked at the java.lang.constant.ClassDesc interface which is 
similar in spirit to what MemoryLayout does: an interface that is not 
meant to be implemented by the user. There are many default methods 
there, and no implSpec, except for displayName() (to describe what the 
implementation does).

I'm really on the fence for byteAlignment() as the method javadoc is 
already clear enough about what the method does?

Maurizio

On 08/01/2020 15:22, Maurizio Cimadamore wrote:
> How strongly do we feel about adding an @implSpec note for the default 
> method - given that this method is not supposed to be overridden? 
> (this is captured in the toplevel javadoc, where we say that users are 
> not expected to implement the memory layout interface).