--- old/src/java.desktop/share/classes/java/applet/AppletStub.java 2018-10-07 22:25:16.000000000 -0700 +++ new/src/java.desktop/share/classes/java/applet/AppletStub.java 2018-10-07 22:25:15.000000000 -0700 @@ -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. - * - * @author Arthur van Hoff - * @see java.applet.Applet#setStub(java.applet.AppletStub) - * @since 1.0 + * 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 * @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: *
      *    http://www.oracle.com/technetwork/java/index.html
      * 
@@ -65,51 +61,50 @@ * http://www.oracle.com/technetwork/java/index.html * * - * @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 *
      * <applet code="Clock" width=50 height=50>
      * <param name=Color value="blue">
      * </applet>
      * 
*

- * 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); }