--- a/src/java.base/share/classes/java/lang/Integer.java	Sat Nov 03 12:37:55 2018 -0700
+++ b/src/java.base/share/classes/java/lang/Integer.java	Sat Nov 03 15:40:19 2018 -0400
@@ -992,6 +992,12 @@
      * During VM initialization, java.lang.Integer.IntegerCache.high property
      * may be set and saved in the private system properties in the
      * jdk.internal.misc.VM class.
+     *
+     * WARNING: The cache is archived with CDS and reloaded from the shared
+     * archive at runtime. The archived cache (Integer[]) and Integer objects
+     * reside in the closed archive heap regions. Care should be taken when
+     * changing the implementation and the cache array should not be assigned
+     * with new Integer object(s) after initialization.
      */
 
     private static class IntegerCache {