--- a/jdk/src/share/classes/java/time/LocalDate.java	Mon Jan 06 13:20:06 2014 -0800
+++ b/jdk/src/share/classes/java/time/LocalDate.java	Wed Dec 11 16:52:41 2013 -0500
@@ -122,6 +122,13 @@
  * However, any application that makes use of historical dates, and requires them
  * to be accurate will find the ISO-8601 approach unsuitable.
  *
+ * <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 LocalDate} 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.
  *