JDK 9 RFR of JDK-8071434: doc updates for java.lang.Object
joe darcy
joe.darcy at oracle.com
Thu Jan 29 20:53:58 UTC 2015
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
More information about the core-libs-dev
mailing list