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

[Maurizio Cimadamore]

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.

I agree that the new text I've added should be added as normative text.

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).

Maurizio

On 08/01/2020 15:16, Chris Hegarty wrote:
>
>> On 8 Jan 2020, at 15:07, Chris Hegarty <chris.hegarty at oracle.com> wrote:
>>
>> 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/
> Forgot to add... MemoryAddress equality has no temporal awareness. Is this worth calling out in the new apiNote ?
>
> -Chris.
>