--- a/jdk/src/share/classes/java/time/Instant.java Mon Jan 06 13:20:06 2014 -0800
+++ b/jdk/src/share/classes/java/time/Instant.java Wed Dec 11 16:52:41 2013 -0500
@@ -197,6 +197,13 @@
* This includes {@code Instant}, {@code LocalDate}, {@code LocalTime}, {@code OffsetDateTime},
* {@code ZonedDateTime} and {@code Duration}.
*
+ * <p>
+ * This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a>
+ * class; use of identity-sensitive operations (including reference equality
+ * ({@code ==}), identity hash code, or synchronization) on instances of
+ * {@code Instant} may have unpredictable results and should be avoided.
+ * The {@code equals} method should be used for comparisons.
+ *
* @implSpec
* This class is immutable and thread-safe.
*