[jdk17] RFR: 8269096: Add java.util.Objects.newIdentity method [v3]

[Roger Riggs]

On Tue, 22 Jun 2021 18:01:46 GMT, Chris Hegarty <chegar at openjdk.org> wrote:

>> Roger Riggs has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Update copyright in BasicObjectsTest
>
> src/java.base/share/classes/java/util/Objects.java line 492:
> 
>> 490:     /**
>> 491:      * {@return a new instance of an unspecified class}
>> 492:      * The object has a unique identity; no other references to it exist.
> 
> Is this a new javadoc style/tag ?

Yes, it optimizes the case where the first sentence and the @ return tags have the same string.
See [JDK-8075778](https://bugs.openjdk.java.net/browse/JDK-8075778): Add javadoc tag to avoid duplication of return information in simple situations.

-------------

PR: https://git.openjdk.java.net/jdk17/pull/112