src/java.desktop/share/classes/java/applet/package.html

*** 37,46 ****
--- 37,51 ----
  <p>
  The applet context is an application that is responsible for loading and running
  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>
  
  ##### FILL IN ANY SPECS NEEDED BY JAVA COMPATIBILITY KIT #####
  <ul>