diff -r 3e6b0718041e -r 99859c0e9a33 jdk/src/share/classes/java/time/Year.java --- a/jdk/src/share/classes/java/time/Year.java Mon Jan 06 13:20:06 2014 -0800 +++ b/jdk/src/share/classes/java/time/Year.java Wed Dec 11 16:52:41 2013 -0500 @@ -120,6 +120,13 @@ * However, any application that makes use of historical dates, and requires them * to be accurate will find the ISO-8601 approach unsuitable. * + *

+ * This is a value-based + * class; use of identity-sensitive operations (including reference equality + * ({@code ==}), identity hash code, or synchronization) on instances of + * {@code Year} 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. *