changeset 52897:52ea97fb80b0

8211833: Javadoc cleanup of java.applet package Reviewed-by: prr
author serb
date Tue, 13 Nov 2018 16:35:58 -0800
parents 7199c4da1a6f
children d569b5e29021
files 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
diffstat 4 files changed, 330 insertions(+), 350 deletions(-) [+]
line wrap: on
line diff
--- a/src/java.desktop/share/classes/java/applet/Applet.java	Tue Nov 13 07:11:50 2018 -0800
+++ b/src/java.desktop/share/classes/java/applet/Applet.java	Tue Nov 13 16:35:58 2018 -0800
@@ -31,6 +31,7 @@
 import java.awt.HeadlessException;
 import java.awt.Image;
 import java.awt.Panel;
+import java.awt.event.ComponentEvent;
 import java.io.IOException;
 import java.io.ObjectInputStream;
 import java.net.MalformedURLException;
@@ -45,18 +46,17 @@
 import com.sun.media.sound.JavaSoundAudioClip;
 
 /**
- * An applet is a small program that is intended not to be run on
- * its own, but rather to be embedded inside another application.
+ * An applet is a small program that is intended not to be run on its own, but
+ * rather to be embedded inside another application.
  * <p>
- * The {@code Applet} class must be the superclass of any
- * applet that is to be embedded in a Web page or viewed by the Java
- * Applet Viewer. The {@code Applet} class provides a standard
- * interface between applets and their environment.
+ * The {@code Applet} class must be the superclass of any applet that is to be
+ * embedded in a Web page or viewed by the Java Applet Viewer. The
+ * {@code Applet} class provides a standard interface between applets and their
+ * environment.
  *
- * @author      Arthur van Hoff
- * @author      Chris Warth
- * @since       1.0
- *
+ * @author Arthur van Hoff
+ * @author Chris Warth
+ * @since 1.0
  * @deprecated The Applet API is deprecated, no replacement.
  */
 @Deprecated(since = "9")
@@ -65,13 +65,12 @@
     /**
      * Constructs a new Applet.
      * <p>
-     * Note: Many methods in {@code java.applet.Applet}
-     * may be invoked by the applet only after the applet is
-     * fully constructed; applet should avoid calling methods
-     * in {@code java.applet.Applet} in the constructor.
+     * Note: Many methods in {@code java.applet.Applet} may be invoked by the
+     * applet only after the applet is fully constructed; applet should avoid
+     * calling methods in {@code java.applet.Applet} in the constructor.
      *
-     * @exception HeadlessException if GraphicsEnvironment.isHeadless()
-     * returns true.
+     * @throws HeadlessException if {@code GraphicsEnvironment.isHeadless()}
+     *         returns {@code true}
      * @see java.awt.GraphicsEnvironment#isHeadless
      * @since 1.4
      */
@@ -83,26 +82,26 @@
 
     /**
      * Applets can be serialized but the following conventions MUST be followed:
-     *
-     * Before Serialization:
-     * An applet must be in STOPPED state.
-     *
-     * After Deserialization:
-     * The applet will be restored in STOPPED state (and most clients will
-     * likely move it into RUNNING state).
-     * The stub field will be restored by the reader.
+     * <p>
+     * Before Serialization: An applet must be in STOPPED state.
+     * <p>
+     * After Deserialization: The applet will be restored in STOPPED state (and
+     * most clients will likely move it into RUNNING state). The stub field will
+     * be restored by the reader.
      */
     private transient AppletStub stub;
 
-    /* version ID for serialized form. */
+    /**
+     * Use serialVersionUID from JDK 1.0 for interoperability.
+     */
     private static final long serialVersionUID = -5836846270535785031L;
 
     /**
      * Read an applet from an object input stream.
-     * @param  s  an object input stream.
-     * @exception HeadlessException if
-     * {@code GraphicsEnvironment.isHeadless()} returns
-     * {@code true}
+     *
+     * @param  s an object input stream
+     * @throws HeadlessException if {@code GraphicsEnvironment.isHeadless()}
+     *         returns {@code true}
      * @serial
      * @see java.awt.GraphicsEnvironment#isHeadless
      * @since 1.4
@@ -117,12 +116,13 @@
 
     /**
      * Sets this applet's stub. This is done automatically by the system.
-     * <p>If there is a security manager, its {@code checkPermission}
-     * method is called with the
-     * {@code AWTPermission("setAppletStub")}
-     * permission if a stub has already been set.
-     * @param   stub   the new stub.
-     * @exception SecurityException if the caller cannot set the stub
+     * <p>
+     * If there is a security manager, its {@code checkPermission} method is
+     * called with the {@code AWTPermission("setAppletStub")} permission if a
+     * stub has already been set.
+     *
+     * @param  stub the new stub
+     * @throws SecurityException if the caller cannot set the stub
      */
     public final void setStub(AppletStub stub) {
         if (this.stub != null) {
@@ -135,14 +135,13 @@
     }
 
     /**
-     * Determines if this applet is active. An applet is marked active
-     * just before its {@code start} method is called. It becomes
-     * inactive just before its {@code stop} method is called.
+     * Determines if this applet is active. An applet is marked active just
+     * before its {@code start} method is called. It becomes inactive just
+     * before its {@code stop} method is called.
      *
-     * @return  {@code true} if the applet is active;
-     *          {@code false} otherwise.
-     * @see     java.applet.Applet#start()
-     * @see     java.applet.Applet#stop()
+     * @return {@code true} if the applet is active; {@code false} otherwise
+     * @see java.applet.Applet#start()
+     * @see java.applet.Applet#stop()
      */
     public boolean isActive() {
         if (stub != null) {
@@ -153,9 +152,8 @@
     }
 
     /**
-     * Gets the URL of the document in which this applet is embedded.
-     * For example, suppose an applet is contained
-     * within the document:
+     * Gets the {@code URL} of the document in which this applet is embedded.
+     * For example, suppose an applet is contained within the document:
      * <blockquote><pre>
      *    http://www.oracle.com/technetwork/java/index.html
      * </pre></blockquote>
@@ -164,55 +162,55 @@
      *    http://www.oracle.com/technetwork/java/index.html
      * </pre></blockquote>
      *
-     * @return  the {@link java.net.URL} of the document that contains this
-     *          applet.
-     * @see     java.applet.Applet#getCodeBase()
+     * @return the {@link java.net.URL} of the document that contains this
+     *         applet
+     * @see java.applet.Applet#getCodeBase()
      */
     public URL getDocumentBase() {
         return stub.getDocumentBase();
     }
 
     /**
-     * Gets the base URL. This is the URL of the directory which contains this applet.
+     * Gets the base {@code URL}. This is the {@code URL} of the directory which
+     * contains this applet.
      *
-     * @return  the base {@link java.net.URL} of
-     *          the directory which contains this applet.
-     * @see     java.applet.Applet#getDocumentBase()
+     * @return the base {@link java.net.URL} of the directory which contains
+     *         this applet
+     * @see java.applet.Applet#getDocumentBase()
      */
     public URL getCodeBase() {
         return stub.getCodeBase();
     }
 
     /**
-     * Returns the value of the named parameter in the HTML tag. For
-     * example, if this applet is specified as
+     * Returns the value of the named parameter in the HTML tag. For example, if
+     * this applet is specified as
      * <blockquote><pre>
      * &lt;applet code="Clock" width=50 height=50&gt;
      * &lt;param name=Color value="blue"&gt;
      * &lt;/applet&gt;
      * </pre></blockquote>
      * <p>
-     * then a call to {@code getParameter("Color")} returns the
-     * value {@code "blue"}.
+     * then a call to {@code getParameter("Color")} returns the value
+     * {@code "blue"}.
      * <p>
      * The {@code name} argument is case insensitive.
      *
-     * @param   name   a parameter name.
-     * @return  the value of the named parameter,
-     *          or {@code null} if not set.
+     * @param  name a parameter name
+     * @return the value of the named parameter, or {@code null} if not set
      */
-     public String getParameter(String name) {
-         return stub.getParameter(name);
-     }
+    public String getParameter(String name) {
+        return stub.getParameter(name);
+    }
 
     /**
-     * Determines this applet's context, which allows the applet to
-     * query and affect the environment in which it runs.
+     * Determines this applet's context, which allows the applet to query and
+     * affect the environment in which it runs.
      * <p>
-     * This environment of an applet represents the document that
-     * contains the applet.
+     * This environment of an applet represents the document that contains the
+     * applet.
      *
-     * @return  the applet's context.
+     * @return the applet's context
      */
     public AppletContext getAppletContext() {
         return stub.getAppletContext();
@@ -221,8 +219,8 @@
     /**
      * Requests that this applet be resized.
      *
-     * @param   width    the new requested width for the applet.
-     * @param   height   the new requested height for the applet.
+     * @param  width the new requested width for the applet
+     * @param  height the new requested height for the applet
      */
     @SuppressWarnings("deprecation")
     public void resize(int width, int height) {
@@ -238,7 +236,7 @@
     /**
      * Requests that this applet be resized.
      *
-     * @param   d   an object giving the new width and height.
+     * @param  d an object giving the new width and height
      */
     @SuppressWarnings("deprecation")
     public void resize(Dimension d) {
@@ -252,8 +250,8 @@
      * override this method to return {@code true}.
      *
      * @return {@code true}
+     * @see java.awt.Container#isValidateRoot
      * @since 1.7
-     * @see java.awt.Container#isValidateRoot
      */
     @Override
     public boolean isValidateRoot() {
@@ -261,51 +259,50 @@
     }
 
     /**
-     * Requests that the argument string be displayed in the
-     * "status window". Many browsers and applet viewers
-     * provide such a window, where the application can inform users of
-     * its current state.
+     * Requests that the argument string be displayed in the "status window".
+     * Many browsers and applet viewers provide such a window, where the
+     * application can inform users of its current state.
      *
-     * @param   msg   a string to display in the status window.
+     * @param  msg a string to display in the status window
      */
     public void showStatus(String msg) {
         getAppletContext().showStatus(msg);
     }
 
     /**
-     * Returns an {@code Image} object that can then be painted on
-     * the screen. The {@code url} that is passed as an argument
-     * must specify an absolute URL.
+     * Returns an {@code Image} object that can then be painted on the screen.
+     * The {@code url} that is passed as an argument must specify an absolute
+     * {@code URL}.
      * <p>
-     * This method always returns immediately, whether or not the image
-     * exists. When this applet attempts to draw the image on the screen,
-     * the data will be loaded. The graphics primitives that draw the
-     * image will incrementally paint on the screen.
+     * This method always returns immediately, whether or not the image exists.
+     * When this applet attempts to draw the image on the screen, the data will
+     * be loaded. The graphics primitives that draw the image will incrementally
+     * paint on the screen.
      *
-     * @param   url   an absolute URL giving the location of the image.
-     * @return  the image at the specified URL.
-     * @see     java.awt.Image
+     * @param  url an absolute {@code URL} giving the location of the image
+     * @return the image at the specified {@code URL}
+     * @see java.awt.Image
      */
     public Image getImage(URL url) {
         return getAppletContext().getImage(url);
     }
 
     /**
-     * Returns an {@code Image} object that can then be painted on
-     * the screen. The {@code url} argument must specify an absolute
-     * URL. The {@code name} argument is a specifier that is
-     * relative to the {@code url} argument.
+     * Returns an {@code Image} object that can then be painted on the screen.
+     * The {@code url} argument must specify an absolute {@code URL}. The
+     * {@code name} argument is a specifier that is relative to the {@code url}
+     * argument.
      * <p>
-     * This method always returns immediately, whether or not the image
-     * exists. When this applet attempts to draw the image on the screen,
-     * the data will be loaded. The graphics primitives that draw the
-     * image will incrementally paint on the screen.
+     * This method always returns immediately, whether or not the image exists.
+     * When this applet attempts to draw the image on the screen, the data will
+     * be loaded. The graphics primitives that draw the image will incrementally
+     * paint on the screen.
      *
-     * @param   url    an absolute URL giving the base location of the image.
-     * @param   name   the location of the image, relative to the
-     *                 {@code url} argument.
-     * @return  the image at the specified URL.
-     * @see     java.awt.Image
+     * @param  url an absolute URL giving the base location of the image
+     * @param  name the location of the image, relative to the {@code url}
+     *         argument
+     * @return the image at the specified {@code URL}
+     * @see java.awt.Image
      */
     public Image getImage(URL url, String name) {
         try {
@@ -316,47 +313,46 @@
     }
 
     /**
-     * Get an audio clip from the given URL.
+     * Get an audio clip from the given {@code URL}.
      *
-     * @param url points to the audio clip
-     * @return the audio clip at the specified URL.
-     *
-     * @since       1.2
+     * @param  url points to the audio clip
+     * @return the audio clip at the specified {@code URL}
+     * @since 1.2
      */
     public static final AudioClip newAudioClip(URL url) {
         return JavaSoundAudioClip.create(url);
     }
 
     /**
-     * Returns the {@code AudioClip} object specified by the
-     * {@code URL} argument.
+     * Returns the {@code AudioClip} object specified by the {@code URL}
+     * argument.
      * <p>
-     * This method always returns immediately, whether or not the audio
-     * clip exists. When this applet attempts to play the audio clip, the
-     * data will be loaded.
+     * This method always returns immediately, whether or not the audio clip
+     * exists. When this applet attempts to play the audio clip, the data will
+     * be loaded.
      *
-     * @param   url  an absolute URL giving the location of the audio clip.
-     * @return  the audio clip at the specified URL.
-     * @see     java.applet.AudioClip
+     * @param  url an absolute {@code URL} giving the location of the audio clip
+     * @return the audio clip at the specified {@code URL}
+     * @see java.applet.AudioClip
      */
     public AudioClip getAudioClip(URL url) {
         return getAppletContext().getAudioClip(url);
     }
 
     /**
-     * Returns the {@code AudioClip} object specified by the
-     * {@code URL} and {@code name} arguments.
+     * Returns the {@code AudioClip} object specified by the {@code URL} and
+     * {@code name} arguments.
      * <p>
-     * This method always returns immediately, whether or not the audio
-     * clip exists. When this applet attempts to play the audio clip, the
-     * data will be loaded.
+     * This method always returns immediately, whether or not the audio clip
+     * exists. When this applet attempts to play the audio clip, the data will
+     * be loaded.
      *
-     * @param   url    an absolute URL giving the base location of the
-     *                 audio clip.
-     * @param   name   the location of the audio clip, relative to the
-     *                 {@code url} argument.
-     * @return  the audio clip at the specified URL.
-     * @see     java.applet.AudioClip
+     * @param  url an absolute {@code URL} giving the base location of the audio
+     *         clip
+     * @param  name the location of the audio clip, relative to the {@code url}
+     *         argument
+     * @return the audio clip at the specified {@code URL}
+     * @see java.applet.AudioClip
      */
     public AudioClip getAudioClip(URL url, String name) {
         try {
@@ -367,45 +363,43 @@
     }
 
     /**
-     * Returns information about this applet. An applet should override
-     * this method to return a {@code String} containing information
-     * about the author, version, and copyright of the applet.
+     * Returns information about this applet. An applet should override this
+     * method to return a {@code String} containing information about the
+     * author, version, and copyright of the applet.
      * <p>
-     * The implementation of this method provided by the
-     * {@code Applet} class returns {@code null}.
+     * The implementation of this method provided by the {@code Applet} class
+     * returns {@code null}.
      *
-     * @return  a string containing information about the author, version, and
-     *          copyright of the applet.
+     * @return a string containing information about the author, version, and
+     *         copyright of the applet
      */
     public String getAppletInfo() {
         return null;
     }
 
     /**
-     * Gets the locale of the applet. It allows the applet
-     * to maintain its own locale separated from the locale
-     * of the browser or appletviewer.
+     * Gets the locale of the applet. It allows the applet to maintain its own
+     * locale separated from the locale of the browser or appletviewer.
      *
-     * @return  the locale of the applet; if no locale has
-     *          been set, the default locale is returned.
-     * @since   1.1
+     * @return the locale of the applet; if no locale has been set, the default
+     *         locale is returned
+     * @since 1.1
      */
     public Locale getLocale() {
-      Locale locale = super.getLocale();
-      if (locale == null) {
-        return Locale.getDefault();
-      }
-      return locale;
+        Locale locale = super.getLocale();
+        if (locale == null) {
+            return Locale.getDefault();
+        }
+        return locale;
     }
 
     /**
-     * Returns information about the parameters that are understood by
-     * this applet. An applet should override this method to return an
-     * array of {@code Strings} describing these parameters.
+     * Returns information about the parameters that are understood by this
+     * applet. An applet should override this method to return an array of
+     * strings describing these parameters.
      * <p>
-     * Each element of the array should be a set of three
-     * {@code Strings} containing the name, the type, and a
-     * description. For example:
+     * Each element of the array should be a set of three strings containing the
+     * name, the type, and a description. For example:
      * <blockquote><pre>
      * String pinfo[][] = {
      *   {"fps",    "1-10",    "frames per second"},
@@ -414,20 +408,20 @@
      * };
      * </pre></blockquote>
      * <p>
-     * The implementation of this method provided by the
-     * {@code Applet} class returns {@code null}.
+     * The implementation of this method provided by the {@code Applet} class
+     * returns {@code null}.
      *
-     * @return  an array describing the parameters this applet looks for.
+     * @return an array describing the parameters this applet looks for
      */
     public String[][] getParameterInfo() {
         return null;
     }
 
     /**
-     * Plays the audio clip at the specified absolute URL. Nothing
+     * Plays the audio clip at the specified absolute {@code URL}. Nothing
      * happens if the audio clip cannot be found.
      *
-     * @param   url   an absolute URL giving the location of the audio clip.
+     * @param  url an absolute {@code URL} giving the location of the audio clip
      */
     public void play(URL url) {
         AudioClip clip = getAudioClip(url);
@@ -437,13 +431,13 @@
     }
 
     /**
-     * Plays the audio clip given the URL and a specifier that is
+     * Plays the audio clip given the {@code URL} and a specifier that is
      * relative to it. Nothing happens if the audio clip cannot be found.
      *
-     * @param   url    an absolute URL giving the base location of the
-     *                 audio clip.
-     * @param   name   the location of the audio clip, relative to the
-     *                 {@code url} argument.
+     * @param  url an absolute {@code URL} giving the base location of the audio
+     *         clip
+     * @param  name the location of the audio clip, relative to the {@code url}
+     *         argument
      */
     public void play(URL url, String name) {
         AudioClip clip = getAudioClip(url, name);
@@ -453,98 +447,92 @@
     }
 
     /**
-     * Called by the browser or applet viewer to inform
-     * this applet that it has been loaded into the system. It is always
-     * called before the first time that the {@code start} method is
-     * called.
+     * Called by the browser or applet viewer to inform this applet that it has
+     * been loaded into the system. It is always called before the first time
+     * that the {@code start} method is called.
      * <p>
-     * A subclass of {@code Applet} should override this method if
-     * it has initialization to perform. For example, an applet with
-     * threads would use the {@code init} method to create the
-     * threads and the {@code destroy} method to kill them.
+     * A subclass of {@code Applet} should override this method if it has
+     * initialization to perform. For example, an applet with threads would use
+     * the {@code init} method to create the threads and the {@code destroy}
+     * method to kill them.
      * <p>
-     * The implementation of this method provided by the
-     * {@code Applet} class does nothing.
+     * The implementation of this method provided by the {@code Applet} class
+     * does nothing.
      *
-     * @see     java.applet.Applet#destroy()
-     * @see     java.applet.Applet#start()
-     * @see     java.applet.Applet#stop()
+     * @see java.applet.Applet#destroy()
+     * @see java.applet.Applet#start()
+     * @see java.applet.Applet#stop()
      */
     public void init() {
     }
 
     /**
-     * Called by the browser or applet viewer to inform
-     * this applet that it should start its execution. It is called after
-     * the {@code init} method and each time the applet is revisited
-     * in a Web page.
+     * Called by the browser or applet viewer to inform this applet that it
+     * should start its execution. It is called after the {@code init} method
+     * and each time the applet is revisited in a Web page.
      * <p>
-     * A subclass of {@code Applet} should override this method if
-     * it has any operation that it wants to perform each time the Web
-     * page containing it is visited. For example, an applet with
-     * animation might want to use the {@code start} method to
-     * resume animation, and the {@code stop} method to suspend the
-     * animation.
+     * A subclass of {@code Applet} should override this method if it has any
+     * operation that it wants to perform each time the Web page containing it
+     * is visited. For example, an applet with animation might want to use the
+     * {@code start} method to resume animation, and the {@code stop} method to
+     * suspend the animation.
      * <p>
-     * Note: some methods, such as {@code getLocationOnScreen}, can only
-     * provide meaningful results if the applet is showing.  Because
-     * {@code isShowing} returns {@code false} when the applet's
-     * {@code start} is first called, methods requiring
-     * {@code isShowing} to return {@code true} should be called from
-     * a {@code ComponentListener}.
+     * Note: some methods, such as {@code getLocationOnScreen}, can only provide
+     * meaningful results if the applet is showing. Because {@code isShowing}
+     * returns {@code false} when the applet's {@code start} is first called,
+     * methods requiring {@code isShowing} to return {@code true} should be
+     * called from a {@code ComponentListener}.
      * <p>
-     * The implementation of this method provided by the
-     * {@code Applet} class does nothing.
+     * The implementation of this method provided by the {@code Applet} class
+     * does nothing.
      *
-     * @see     java.applet.Applet#destroy()
-     * @see     java.applet.Applet#init()
-     * @see     java.applet.Applet#stop()
-     * @see     java.awt.Component#isShowing()
-     * @see     java.awt.event.ComponentListener#componentShown(java.awt.event.ComponentEvent)
+     * @see java.applet.Applet#destroy()
+     * @see java.applet.Applet#init()
+     * @see java.applet.Applet#stop()
+     * @see java.awt.Component#isShowing()
+     * @see java.awt.event.ComponentListener#componentShown(ComponentEvent)
      */
     public void start() {
     }
 
     /**
-     * Called by the browser or applet viewer to inform
-     * this applet that it should stop its execution. It is called when
-     * the Web page that contains this applet has been replaced by
-     * another page, and also just before the applet is to be destroyed.
+     * Called by the browser or applet viewer to inform this applet that it
+     * should stop its execution. It is called when the Web page that contains
+     * this applet has been replaced by another page, and also just before the
+     * applet is to be destroyed.
      * <p>
-     * A subclass of {@code Applet} should override this method if
-     * it has any operation that it wants to perform each time the Web
-     * page containing it is no longer visible. For example, an applet
-     * with animation might want to use the {@code start} method to
-     * resume animation, and the {@code stop} method to suspend the
-     * animation.
+     * A subclass of {@code Applet} should override this method if it has any
+     * operation that it wants to perform each time the Web page containing it
+     * is no longer visible. For example, an applet with animation might want to
+     * use the {@code start} method to resume animation, and the {@code stop}
+     * method to suspend the animation.
      * <p>
-     * The implementation of this method provided by the
-     * {@code Applet} class does nothing.
+     * The implementation of this method provided by the {@code Applet} class
+     * does nothing.
      *
-     * @see     java.applet.Applet#destroy()
-     * @see     java.applet.Applet#init()
+     * @see java.applet.Applet#destroy()
+     * @see java.applet.Applet#init()
      */
     public void stop() {
     }
 
     /**
-     * Called by the browser or applet viewer to inform
-     * this applet that it is being reclaimed and that it should destroy
-     * any resources that it has allocated. The {@code stop} method
-     * will always be called before {@code destroy}.
+     * Called by the browser or applet viewer to inform this applet that it is
+     * being reclaimed and that it should destroy any resources that it has
+     * allocated. The {@code stop} method will always be called before
+     * {@code destroy}.
      * <p>
-     * A subclass of {@code Applet} should override this method if
-     * it has any operation that it wants to perform before it is
-     * destroyed. For example, an applet with threads would use the
-     * {@code init} method to create the threads and the
-     * {@code destroy} method to kill them.
+     * A subclass of {@code Applet} should override this method if it has any
+     * operation that it wants to perform before it is destroyed. For example,
+     * an applet with threads would use the {@code init} method to create the
+     * threads and the {@code destroy} method to kill them.
      * <p>
-     * The implementation of this method provided by the
-     * {@code Applet} class does nothing.
+     * The implementation of this method provided by the {@code Applet} class
+     * does nothing.
      *
-     * @see     java.applet.Applet#init()
-     * @see     java.applet.Applet#start()
-     * @see     java.applet.Applet#stop()
+     * @see java.applet.Applet#init()
+     * @see java.applet.Applet#start()
+     * @see java.applet.Applet#stop()
      */
     public void destroy() {
     }
@@ -553,16 +541,19 @@
     // Accessibility support
     //
 
+    /**
+     * The accessible context associated with this {@code Applet}.
+     */
     AccessibleContext accessibleContext = null;
 
     /**
-     * Gets the AccessibleContext associated with this Applet.
-     * For applets, the AccessibleContext takes the form of an
-     * AccessibleApplet.
-     * A new AccessibleApplet instance is created if necessary.
+     * Gets the {@code AccessibleContext} associated with this {@code Applet}.
+     * For applets, the {@code AccessibleContext} takes the form of an
+     * {@code AccessibleApplet}. A new {@code AccessibleApplet} instance is
+     * created if necessary.
      *
-     * @return an AccessibleApplet that serves as the
-     *         AccessibleContext of this Applet
+     * @return an {@code AccessibleApplet} that serves as the
+     *         {@code AccessibleContext} of this {@code Applet}
      * @since 1.3
      */
     public AccessibleContext getAccessibleContext() {
@@ -573,20 +564,24 @@
     }
 
     /**
-     * This class implements accessibility support for the
-     * {@code Applet} class.  It provides an implementation of the
-     * Java Accessibility API appropriate to applet user-interface elements.
+     * This class implements accessibility support for the {@code Applet} class.
+     * It provides an implementation of the Java Accessibility API appropriate
+     * to applet user-interface elements.
+     *
      * @since 1.3
      */
     protected class AccessibleApplet extends AccessibleAWTPanel {
 
+        /**
+         * Use serialVersionUID from JDK 1.3 for interoperability.
+         */
         private static final long serialVersionUID = 8127374778187708896L;
 
         /**
          * Get the role of this object.
          *
-         * @return an instance of AccessibleRole describing the role of the
-         * object
+         * @return an instance of {@code AccessibleRole} describing the role of
+         *         the object
          */
         public AccessibleRole getAccessibleRole() {
             return AccessibleRole.FRAME;
@@ -595,8 +590,8 @@
         /**
          * Get the state of this object.
          *
-         * @return an instance of AccessibleStateSet containing the current
-         * state set of the object
+         * @return an instance of {@code AccessibleStateSet} containing the
+         *         current state set of the object
          * @see AccessibleState
          */
         public AccessibleStateSet getAccessibleStateSet() {
@@ -604,6 +599,5 @@
             states.add(AccessibleState.ACTIVE);
             return states;
         }
-
     }
 }
--- a/src/java.desktop/share/classes/java/applet/AppletContext.java	Tue Nov 13 07:11:50 2018 -0800
+++ b/src/java.desktop/share/classes/java/applet/AppletContext.java	Tue Nov 13 16:35:58 2018 -0800
@@ -33,81 +33,76 @@
 import java.util.Iterator;
 
 /**
- * This interface corresponds to an applet's environment: the
- * document containing the applet and the other applets in the same
- * document.
+ * This interface corresponds to an applet's environment: the document
+ * containing the applet and the other applets in the same document.
  * <p>
- * The methods in this interface can be used by an applet to obtain
- * information about its environment.
+ * The methods in this interface can be used by an applet to obtain information
+ * about its environment.
  *
- * @author      Arthur van Hoff
- * @since       1.0
- *
+ * @author Arthur van Hoff
+ * @since 1.0
  * @deprecated The Applet API is deprecated, no replacement.
  */
 @Deprecated(since = "9")
 public interface AppletContext {
+
     /**
      * Creates an audio clip.
      *
-     * @param   url   an absolute URL giving the location of the audio clip.
-     * @return  the audio clip at the specified URL.
+     * @param  url an absolute {@code URL} giving the location of the audio clip
+     * @return the audio clip at the specified {@code URL}
      */
     AudioClip getAudioClip(URL url);
 
     /**
-     * Returns an {@code Image} object that can then be painted on
-     * the screen. The {@code url} argument that is
-     * passed as an argument must specify an absolute URL.
+     * Returns an {@code Image} object that can then be painted on the screen.
+     * The {@code url} argument that is passed as an argument must specify an
+     * absolute {@code URL}.
      * <p>
-     * This method always returns immediately, whether or not the image
-     * exists. When the applet attempts to draw the image on the screen,
-     * the data will be loaded. The graphics primitives that draw the
-     * image will incrementally paint on the screen.
+     * This method always returns immediately, whether or not the image exists.
+     * When the applet attempts to draw the image on the screen, the data will
+     * be loaded. The graphics primitives that draw the image will incrementally
+     * paint on the screen.
      *
-     * @param   url   an absolute URL giving the location of the image.
-     * @return  the image at the specified URL.
-     * @see     java.awt.Image
+     * @param  url an absolute {@code URL} giving the location of the image
+     * @return the image at the specified {@code URL}
+     * @see java.awt.Image
      */
     Image getImage(URL url);
 
     /**
-     * Finds and returns the applet in the document represented by this
-     * applet context with the given name. The name can be set in the
-     * HTML tag by setting the {@code name} attribute.
+     * Finds and returns the applet in the document represented by this applet
+     * context with the given name. The name can be set in the HTML tag by
+     * setting the {@code name} attribute.
      *
-     * @param   name   an applet name.
-     * @return  the applet with the given name, or {@code null} if
-     *          not found.
+     * @param  name an applet name
+     * @return the applet with the given name, or {@code null} if not found
      */
     Applet getApplet(String name);
 
     /**
-     * Finds all the applets in the document represented by this applet
-     * context.
+     * Finds all the applets in the document represented by this applet context.
      *
-     * @return  an enumeration of all applets in the document represented by
-     *          this applet context.
+     * @return an enumeration of all applets in the document represented by this
+     *         applet context
      */
     Enumeration<Applet> getApplets();
 
     /**
-     * Requests that the browser or applet viewer show the Web page
-     * indicated by the {@code url} argument. The browser or
-     * applet viewer determines which window or frame to display the
-     * Web page. This method may be ignored by applet contexts that
-     * are not browsers.
+     * Requests that the browser or applet viewer show the Web page indicated by
+     * the {@code url} argument. The browser or applet viewer determines which
+     * window or frame to display the Web page. This method may be ignored by
+     * applet contexts that are not browsers.
      *
-     * @param   url   an absolute URL giving the location of the document.
+     * @param url an absolute {@code URL} giving the location of the document
      */
     void showDocument(URL url);
 
     /**
-     * Requests that the browser or applet viewer show the Web page
-     * indicated by the {@code url} argument. The
-     * {@code target} argument indicates in which HTML frame the
-     * document is to be displayed.
-     * The target argument is interpreted as follows:
+     * Requests that the browser or applet viewer show the Web page indicated by
+     * the {@code url} argument. The {@code target} argument indicates in which
+     * HTML frame the document is to be displayed. The target argument is
+     * interpreted as follows:
      *
      * <table class="striped">
      * <caption>Target arguments and their descriptions</caption>
@@ -141,53 +136,50 @@
      * <p>
      * An applet viewer or browser is free to ignore {@code showDocument}.
      *
-     * @param   url   an absolute URL giving the location of the document.
-     * @param   target   a {@code String} indicating where to display
-     *                   the page.
+     * @param  url an absolute {@code URL} giving the location of the document
+     * @param  target a {@code String} indicating where to display the page
      */
     public void showDocument(URL url, String target);
 
     /**
-     * Requests that the argument string be displayed in the
-     * "status window". Many browsers and applet viewers
-     * provide such a window, where the application can inform users of
-     * its current state.
+     * Requests that the argument string be displayed in the "status window".
+     * Many browsers and applet viewers provide such a window, where the
+     * application can inform users of its current state.
      *
-     * @param   status   a string to display in the status window.
+     * @param  status a string to display in the status window
      */
     void showStatus(String status);
 
     /**
-     * Associates the specified stream with the specified key in this
-     * applet context. If the applet context previously contained a mapping
-     * for this key, the old value is replaced.
+     * Associates the specified stream with the specified key in this applet
+     * context. If the applet context previously contained a mapping for this
+     * key, the old value is replaced.
      * <p>
      * For security reasons, mapping of streams and keys exists for each
-     * codebase. In other words, applet from one codebase cannot access
-     * the streams created by an applet from a different codebase
+     * codebase. In other words, applet from one codebase cannot access the
+     * streams created by an applet from a different codebase
      *
-     * @param key key with which the specified value is to be associated.
-     * @param stream stream to be associated with the specified key. If this
-     *               parameter is {@code null}, the specified key is removed
-     *               in this applet context.
-     * @throws IOException if the stream size exceeds a certain
-     *         size limit. Size limit is decided by the implementor of this
-     *         interface.
+     * @param  key key with which the specified value is to be associated
+     * @param  stream stream to be associated with the specified key. If this
+     *         parameter is {@code null}, the specified key is removed in this
+     *         applet context.
+     * @throws IOException if the stream size exceeds a certain size limit. Size
+     *         limit is decided by the implementor of this interface.
      * @since 1.4
      */
-    public void setStream(String key, InputStream stream)throws IOException;
+    public void setStream(String key, InputStream stream) throws IOException;
 
     /**
      * Returns the stream to which specified key is associated within this
-     * applet context. Returns {@code null} if the applet context contains
-     * no stream for this key.
+     * applet context. Returns {@code null} if the applet context contains no
+     * stream for this key.
      * <p>
      * For security reasons, mapping of streams and keys exists for each
-     * codebase. In other words, applet from one codebase cannot access
-     * the streams created by an applet from a different codebase
+     * codebase. In other words, applet from one codebase cannot access the
+     * streams created by an applet from a different codebase.
      *
+     * @param  key key whose associated stream is to be returned
      * @return the stream to which this applet context maps the key
-     * @param key key whose associated stream is to be returned.
      * @since 1.4
      */
     public InputStream getStream(String key);
@@ -196,11 +188,11 @@
      * Finds all the keys of the streams in this applet context.
      * <p>
      * For security reasons, mapping of streams and keys exists for each
-     * codebase. In other words, applet from one codebase cannot access
-     * the streams created by an applet from a different codebase
+     * codebase. In other words, applet from one codebase cannot access the
+     * streams created by an applet from a different codebase.
      *
-     * @return  an Iterator of all the names of the streams in this applet
-     *          context.
+     * @return an {@code Iterator} of all the names of the streams in this
+     *         applet context
      * @since 1.4
      */
     public Iterator<String> getStreamKeys();
--- a/src/java.desktop/share/classes/java/applet/AppletStub.java	Tue Nov 13 07:11:50 2018 -0800
+++ b/src/java.desktop/share/classes/java/applet/AppletStub.java	Tue Nov 13 16:35:58 2018 -0800
@@ -28,35 +28,31 @@
 import java.net.URL;
 
 /**
- * When an applet is first created, an applet stub is attached to it
- * using the applet's {@code setStub} method. This stub
- * serves as the interface between the applet and the browser
- * environment or applet viewer environment in which the application
- * is running.
+ * When an applet is first created, an applet stub is attached to it using the
+ * applet's {@code setStub} method. This stub serves as the interface between
+ * the applet and the browser environment or applet viewer environment in which
+ * the application is running.
  *
- * @author      Arthur van Hoff
- * @see         java.applet.Applet#setStub(java.applet.AppletStub)
- * @since       1.0
- *
+ * @author Arthur van Hoff
+ * @see java.applet.Applet#setStub(java.applet.AppletStub)
+ * @since 1.0
  * @deprecated The Applet API is deprecated, no replacement.
  */
 @Deprecated(since = "9")
 public interface AppletStub {
+
     /**
-     * Determines if the applet is active. An applet is active just
-     * before its {@code start} method is called. It becomes
-     * inactive just before its {@code stop} method is called.
+     * Determines if the applet is active. An applet is active just before its
+     * {@code start} method is called. It becomes inactive just before its
+     * {@code stop} method is called.
      *
-     * @return  {@code true} if the applet is active;
-     *          {@code false} otherwise.
+     * @return {@code true} if the applet is active; {@code false} otherwise
      */
     boolean isActive();
 
-
     /**
-     * Gets the URL of the document in which the applet is embedded.
-     * For example, suppose an applet is contained
-     * within the document:
+     * Gets the {@code URL} of the document in which the applet is embedded. For
+     * example, suppose an applet is contained within the document:
      * <blockquote><pre>
      *    http://www.oracle.com/technetwork/java/index.html
      * </pre></blockquote>
@@ -65,51 +61,50 @@
      *    http://www.oracle.com/technetwork/java/index.html
      * </pre></blockquote>
      *
-     * @return  the {@link java.net.URL} of the document that contains the
-     *          applet.
-     * @see     java.applet.AppletStub#getCodeBase()
+     * @return the {@link java.net.URL} of the document that contains the applet
+     * @see java.applet.AppletStub#getCodeBase()
      */
     URL getDocumentBase();
 
     /**
-     * Gets the base URL. This is the URL of the directory which contains the applet.
+     * Gets the base {@code URL}. This is the {@code URL} of the directory which
+     * contains the applet.
      *
-     * @return  the base {@link java.net.URL} of
-     *          the directory which contains the applet.
-     * @see     java.applet.AppletStub#getDocumentBase()
+     * @return the base {@link java.net.URL} of the directory which contains the
+     *         applet
+     * @see java.applet.AppletStub#getDocumentBase()
      */
     URL getCodeBase();
 
     /**
-     * Returns the value of the named parameter in the HTML tag. For
-     * example, if an applet is specified as
+     * Returns the value of the named parameter in the HTML tag. For example, if
+     * an applet is specified as
      * <blockquote><pre>
      * &lt;applet code="Clock" width=50 height=50&gt;
      * &lt;param name=Color value="blue"&gt;
      * &lt;/applet&gt;
      * </pre></blockquote>
      * <p>
-     * then a call to {@code getParameter("Color")} returns the
-     * value {@code "blue"}.
+     * then a call to {@code getParameter("Color")} returns the value
+     * {@code "blue"}.
      *
-     * @param   name   a parameter name.
-     * @return  the value of the named parameter,
-     * or {@code null} if not set.
+     * @param  name a parameter name
+     * @return the value of the named parameter, or {@code null} if not set
      */
     String getParameter(String name);
 
     /**
      * Returns the applet's context.
      *
-     * @return  the applet's context.
+     * @return the applet's context
      */
     AppletContext getAppletContext();
 
     /**
      * Called when the applet wants to be resized.
      *
-     * @param   width    the new requested width for the applet.
-     * @param   height   the new requested height for the applet.
+     * @param  width the new requested width for the applet
+     * @param  height the new requested height for the applet
      */
     void appletResize(int width, int height);
 }
--- a/src/java.desktop/share/classes/java/applet/AudioClip.java	Tue Nov 13 07:11:50 2018 -0800
+++ b/src/java.desktop/share/classes/java/applet/AudioClip.java	Tue Nov 13 16:35:58 2018 -0800
@@ -26,21 +26,20 @@
 package java.applet;
 
 /**
- * The {@code AudioClip} interface is a simple abstraction for
- * playing a sound clip. Multiple {@code AudioClip} items can be
- * playing at the same time, and the resulting sound is mixed
- * together to produce a composite.
+ * The {@code AudioClip} interface is a simple abstraction for playing a sound
+ * clip. Multiple {@code AudioClip} items can be playing at the same time, and
+ * the resulting sound is mixed together to produce a composite.
  *
- * @author      Arthur van Hoff
- * @since       1.0
- *
+ * @author Arthur van Hoff
+ * @since 1.0
  * @deprecated The Applet API is deprecated, no replacement.
  */
 @Deprecated(since = "9")
 public interface AudioClip {
+
     /**
-     * Starts playing this audio clip. Each time this method is called,
-     * the clip is restarted from the beginning.
+     * Starts playing this audio clip. Each time this method is called, the clip
+     * is restarted from the beginning.
      */
     void play();