--- old/src/java.desktop/share/classes/java/applet/package.html	2016-05-13 19:14:04.354523600 -0700
+++ new/src/java.desktop/share/classes/java/applet/package.html	2016-05-13 19:14:03.584485100 -0700
@@ -39,6 +39,11 @@
 applets. For example, the applet context could be a Web browser or an applet
 development environment.
 <p>
+The APIs in this package are all deprecated. Alternative technologies such as Java Web Start
+or installable applications should be used instead. See <a href="http://openjdk.java.net/jeps/289">JEP 289</a>
+and the Oracle White Paper <a href="http://www.oracle.com/technetwork/java/javase/migratingfromapplets-2872444.pdf">
+"Migrating from Java Applets to plugin-free Java technologies"</a> for more information.
+<p>
 <!--
 <h2>Package Specification</h2>