8203498: The specification for java.applet package should be updated
authorserb
Wed, 23 May 2018 23:02:02 -0700
changeset 50345 276cb4b17f79
parent 50344 8039dc75f125
child 50346 9e530b150333
8203498: The specification for java.applet package should be updated Reviewed-by: prr
src/java.desktop/share/classes/java/applet/Applet.java
src/java.desktop/share/classes/java/applet/AppletContext.java
src/java.desktop/share/classes/java/applet/AppletStub.java
src/java.desktop/share/classes/java/applet/AudioClip.java
src/java.desktop/share/classes/java/applet/package-info.java
src/java.desktop/share/classes/javax/swing/JApplet.java
--- a/src/java.desktop/share/classes/java/applet/Applet.java	Tue May 22 17:33:31 2018 -0700
+++ b/src/java.desktop/share/classes/java/applet/Applet.java	Wed May 23 23:02:02 2018 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2016, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2018, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -22,17 +22,25 @@
  * or visit www.oracle.com if you need additional information or have any
  * questions.
  */
+
 package java.applet;
 
-import java.awt.*;
-import java.awt.image.ColorModel;
+import java.awt.AWTPermission;
+import java.awt.Dimension;
+import java.awt.GraphicsEnvironment;
+import java.awt.HeadlessException;
+import java.awt.Image;
+import java.awt.Panel;
 import java.io.IOException;
 import java.io.ObjectInputStream;
+import java.net.MalformedURLException;
 import java.net.URL;
-import java.net.MalformedURLException;
-import java.util.Hashtable;
 import java.util.Locale;
-import javax.accessibility.*;
+
+import javax.accessibility.AccessibleContext;
+import javax.accessibility.AccessibleRole;
+import javax.accessibility.AccessibleState;
+import javax.accessibility.AccessibleStateSet;
 
 /**
  * An applet is a small program that is intended not to be run on
@@ -47,11 +55,8 @@
  * @author      Chris Warth
  * @since       1.0
  *
- * @deprecated  The Applet API is deprecated. See the
- * <a href="package-summary.html"> java.applet package documentation</a>
- * for further information.
+ * @deprecated The Applet API is deprecated, no replacement.
  */
-
 @Deprecated(since = "9")
 public class Applet extends Panel {
 
--- a/src/java.desktop/share/classes/java/applet/AppletContext.java	Tue May 22 17:33:31 2018 -0700
+++ b/src/java.desktop/share/classes/java/applet/AppletContext.java	Wed May 23 23:02:02 2018 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2018, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -26,12 +26,10 @@
 package java.applet;
 
 import java.awt.Image;
-import java.awt.Graphics;
-import java.awt.image.ColorModel;
+import java.io.IOException;
+import java.io.InputStream;
 import java.net.URL;
 import java.util.Enumeration;
-import java.io.InputStream;
-import java.io.IOException;
 import java.util.Iterator;
 
 /**
@@ -45,11 +43,8 @@
  * @author      Arthur van Hoff
  * @since       1.0
  *
- * @deprecated  The Applet API is deprecated. See the
- * <a href="package-summary.html"> java.applet package documentation</a>
- * for further information.
+ * @deprecated The Applet API is deprecated, no replacement.
  */
-
 @Deprecated(since = "9")
 public interface AppletContext {
     /**
--- a/src/java.desktop/share/classes/java/applet/AppletStub.java	Tue May 22 17:33:31 2018 -0700
+++ b/src/java.desktop/share/classes/java/applet/AppletStub.java	Wed May 23 23:02:02 2018 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2016, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2018, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -22,6 +22,7 @@
  * or visit www.oracle.com if you need additional information or have any
  * questions.
  */
+
 package java.applet;
 
 import java.net.URL;
@@ -37,11 +38,8 @@
  * @see         java.applet.Applet#setStub(java.applet.AppletStub)
  * @since       1.0
  *
- * @deprecated  The Applet API is deprecated. See the
- * <a href="package-summary.html"> java.applet package documentation</a>
- * for further information.
+ * @deprecated The Applet API is deprecated, no replacement.
  */
-
 @Deprecated(since = "9")
 public interface AppletStub {
     /**
--- a/src/java.desktop/share/classes/java/applet/AudioClip.java	Tue May 22 17:33:31 2018 -0700
+++ b/src/java.desktop/share/classes/java/applet/AudioClip.java	Wed May 23 23:02:02 2018 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2016, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2018, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -34,11 +34,8 @@
  * @author      Arthur van Hoff
  * @since       1.0
  *
- * @deprecated  The Applet API is deprecated. See the
- * <a href="package-summary.html">java.applet package documentation</a>
- * for further information.
+ * @deprecated The Applet API is deprecated, no replacement.
  */
-
 @Deprecated(since = "9")
 public interface AudioClip {
     /**
--- a/src/java.desktop/share/classes/java/applet/package-info.java	Tue May 22 17:33:31 2018 -0700
+++ b/src/java.desktop/share/classes/java/applet/package-info.java	Wed May 23 23:02:02 2018 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 2018, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -36,13 +36,7 @@
  * 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.
+ * The APIs in this package are all deprecated without replacement.
  *
  * @since 1.0
  */
--- a/src/java.desktop/share/classes/javax/swing/JApplet.java	Tue May 22 17:33:31 2018 -0700
+++ b/src/java.desktop/share/classes/javax/swing/JApplet.java	Wed May 23 23:02:02 2018 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2016, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -22,6 +22,7 @@
  * or visit www.oracle.com if you need additional information or have any
  * questions.
  */
+
 package javax.swing;
 
 import java.applet.Applet;
@@ -93,11 +94,8 @@
  * @author Arnaud Weber
  * @since 1.2
  *
- * @deprecated  The Applet API is deprecated. See the
- * <a href="../../java/applet/package-summary.html"> java.applet package documentation</a>
- * for further information.
+ * @deprecated The Applet API is deprecated, no replacement.
  */
-
 @Deprecated(since = "9")
 @JavaBean(defaultProperty = "JMenuBar", description = "Swing's Applet subclass.")
 @SwingContainer(delegate = "getContentPane")