RFR: JDK-8310571: Use inline @return tag on java.util.Objects

[Pavel Rappo]

On Thu, 22 Jun 2023 00:19:03 GMT, Joe Darcy <darcy at openjdk.org> wrote:

> Small cleanup, minor differences in the wording of portions of toString(Object, String), nonNull(Object), requireNonNullElse, and requireNonNullElseGet.

I can see that `Objects.hash(Object...)` was not changed in this PR. Although I think I can see why, I wonder if any distinctions between "Generates" and "Returns" are not important in that context:

   /**
    * Generates a hash code for a sequence of input values. The hash
...
    * @return a hash value of the sequence of input values
...
    */
    public static int hash(Object... values) {

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

PR Comment: https://git.openjdk.org/jdk/pull/14608#issuecomment-1602410131