JDK 9 RFR of JDK-8071434: doc updates for java.lang.Object

[Martijn Verburg]

Perhaps the authors in question would be happy to have a publicly hosted
snippet of that useful information?  I have both books but can appreciate
that there's a *large* number of Java devs who can't afford or get access
to those.

Cheers,
Martijn

On 29 January 2015 at 21:03, Roger Riggs <Roger.Riggs at oracle.com> wrote:

> Hi Joe,
>
> Looks fine (though I don't have the books to verify the references).
>
> Roger
>
>
> On 1/29/2015 3:53 PM, joe darcy wrote:
>
>> Hello,
>>
>> Please review a few doc updates for java.lang.Object:
>>
>>      JDK-8071434: doc updates for java.lang.Object
>>     http://cr.openjdk.java.net/~darcy/8071434.0/
>>
>> Patch below.
>>
>> Thanks,
>>
>> -Joe
>>
>> --- old/src/java.base/share/classes/java/lang/Object.java 2015-01-29
>> 12:50:41.099429597 -0800
>> +++ new/src/java.base/share/classes/java/lang/Object.java 2015-01-29
>> 12:50:40.771265589 -0800
>> @@ -1,5 +1,5 @@
>>  /*
>> - * Copyright (c) 1994, 2012, Oracle and/or its affiliates. All rights
>> reserved.
>> + * Copyright (c) 1994, 2015, Oracle and/or its affiliates. All rights
>> reserved.
>>   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
>>   *
>>   * This code is free software; you can redistribute it and/or modify it
>> @@ -86,12 +86,11 @@
>>       *     for unequal objects may improve the performance of hash
>> tables.
>>       * </ul>
>>       * <p>
>> -     * As much as is reasonably practical, the hashCode method defined by
>> -     * class {@code Object} does return distinct integers for distinct
>> -     * objects. (This is typically implemented by converting the internal
>> -     * address of the object into an integer, but this implementation
>> -     * technique is not required by the
>> -     * Java™ programming language.)
>> +     * As much as is reasonably practical, the hashCode method defined
>> +     * by class {@code Object} does return distinct integers for
>> +     * distinct objects. (The hashCode may or may not be implemented
>> +     * as some function of an object's memory address at some point
>> +     * in time.)
>>       *
>>       * @return  a hash code value for this object.
>>       * @see     java.lang.Object#equals(java.lang.Object)
>> @@ -344,10 +343,11 @@
>>       *         ... // Perform action appropriate to condition
>>       *     }
>>       * </pre>
>> -     * (For more information on this topic, see Section 3.2.3 in Doug
>> Lea's
>> -     * "Concurrent Programming in Java (Second Edition)" (Addison-Wesley,
>> -     * 2000), or Item 50 in Joshua Bloch's "Effective Java Programming
>> -     * Language Guide" (Addison-Wesley, 2001).
>> +     *
>> +     * (For more information on this topic, see section 14.2,
>> +     * Condition Queues, in Brian Goetz and others'"Java Concurrency in
>> +     * Practice" (Addison-Wesley, 2006) or Item 69 in Joshua Bloch's
>> +     * "Effective Java (Second Edition)" (Addison-Wesley, 2008).
>>       *
>>       * <p>If the current thread is {@linkplain
>> java.lang.Thread#interrupt()
>>       * interrupted} by any thread before or while it is waiting, then an
>>
>>
>