RFR(m): JEP 269 initial API and skeleton implementation (JDK-8139232)

[John Rose]

On Nov 24, 2015, at 3:27 PM, Stuart Marks <stuart.marks at oracle.com> wrote:
> 
> But in the hypothetical value-typed future, we might want to return value types from at least some of the factory methods. Value types have no notion of identity, so we don't want to make any statements that lead to thinking about the identity of the returned object, even to the extent of saying that it "might" be the "same" instance as one previously returned.
> 
> Based on this, it occurs to me that I should add the "value-based" disclaimer to the relevant section of class doc. (I also note that, off-line, John Rose had already prompted me to do this, so I should heed his advice.)

(Oh, there we go.  Thanks!)