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

[Joe Darcy]

Hello,

On 1/8/2020 7:22 AM, Maurizio Cimadamore wrote:
> Good ideas.
>
> On the implSpec issue I think I got confused by the CSR comment, which 
> was:
>
>> MemoryLayout.byteAlignment() should have an @implSpec tag describing 
>> its default implementation.
>>
> I think now that Joe wanted a tag to describe the default method 
> implementation.

A good rule of thumb is that (by default) a default method should have 
an @implSpec tag describing the operational semantics of the 
implementation. This is especially true when the method is intended to 
be overridden, such as when the default method does something like throw 
UnsupportedOperationException.

HTH,

-Joe