8203498: The specification for java.applet package should be updated
Reviewed-by: prr
--- 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")