src/jdk.jconsole/share/classes/com/sun/tools/jconsole/JConsolePlugin.java

*** 52,62 ****
   * <p> To load the JConsole plugins in JConsole, run:
   *
   * <blockquote><pre>
   * jconsole -pluginpath &lt;plugin-path&gt; </pre></blockquote>
   *
!  * <p> where <tt>&lt;plugin-path&gt;</tt> specifies the paths of JConsole
   * plugins to look up which can be a directory or a jar file. Multiple
   * paths are separated by the path separator character of the platform.
   *
   * <p> When a new JConsole window is created for a connection,
   * an instance of each {@code JConsolePlugin} will be created.
--- 52,62 ----
   * <p> To load the JConsole plugins in JConsole, run:
   *
   * <blockquote><pre>
   * jconsole -pluginpath &lt;plugin-path&gt; </pre></blockquote>
   *
!  * <p> where {@code <plugin-path>} specifies the paths of JConsole
   * plugins to look up which can be a directory or a jar file. Multiple
   * paths are separated by the path separator character of the platform.
   *
   * <p> When a new JConsole window is created for a connection,
   * an instance of each {@code JConsolePlugin} will be created.
*** 104,114 ****
          }
      }
  
      /**
       * Returns the {@link JConsoleContext JConsoleContext} object representing
!      * the connection to an application.  This method may return <tt>null</tt>
       * if it is called before the {@link #setContext context} is initialized.
       *
       * @return the {@link JConsoleContext JConsoleContext} object representing
       *         the connection to an application.
       */
--- 104,114 ----
          }
      }
  
      /**
       * Returns the {@link JConsoleContext JConsoleContext} object representing
!      * the connection to an application.  This method may return {@code null}
       * if it is called before the {@link #setContext context} is initialized.
       *
       * @return the {@link JConsoleContext JConsoleContext} object representing
       *         the connection to an application.
       */
*** 144,171 ****
       * <p>
       * JConsole will invoke the {@link SwingWorker#execute execute()}
       * method to schedule the returned {@code SwingWorker} for execution
       * if:
       * <ul>
!      *   <li> the <tt>SwingWorker</tt> object has not been executed
       *        (i.e. the {@link SwingWorker#getState} method
       *        returns {@link javax.swing.SwingWorker.StateValue#PENDING PENDING}
       *        state); and</li>
!      *   <li> the <tt>SwingWorker</tt> object returned in the previous
!      *        update has completed the task if it was not <tt>null</tt>
       *        (i.e. the {@link SwingWorker#isDone SwingWorker.isDone} method
!      *        returns <tt>true</tt>).</li>
       * </ul>
       * <br>
!      * Otherwise, <tt>SwingWorker</tt> object will not be scheduled to work.
       *
       * <p>
       * A plugin can schedule its own GUI update and this method
!      * will return <tt>null</tt>.
       *
!      * @return a <tt>SwingWorker</tt> to perform the GUI update; or
!      *         <tt>null</tt>.
       */
      public abstract SwingWorker<?,?> newSwingWorker();
  
      /**
       * Dispose this plugin. This method is called by JConsole to inform
--- 144,171 ----
       * <p>
       * JConsole will invoke the {@link SwingWorker#execute execute()}
       * method to schedule the returned {@code SwingWorker} for execution
       * if:
       * <ul>
!      *   <li> the {@code SwingWorker} object has not been executed
       *        (i.e. the {@link SwingWorker#getState} method
       *        returns {@link javax.swing.SwingWorker.StateValue#PENDING PENDING}
       *        state); and</li>
!      *   <li> the {@code SwingWorker} object returned in the previous
!      *        update has completed the task if it was not {@code null}
       *        (i.e. the {@link SwingWorker#isDone SwingWorker.isDone} method
!      *        returns {@code true}).</li>
       * </ul>
       * <br>
!      * Otherwise, {@code SwingWorker} object will not be scheduled to work.
       *
       * <p>
       * A plugin can schedule its own GUI update and this method
!      * will return {@code null}.
       *
!      * @return a {@code SwingWorker} to perform the GUI update; or
!      *         {@code null}.
       */
      public abstract SwingWorker<?,?> newSwingWorker();
  
      /**
       * Dispose this plugin. This method is called by JConsole to inform