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 <[email protected]> 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 >> >> >
