Bug 53442 [Progress] New JFace API methods missing @since
I20040226 ProgressMonitorDialog has several new API methods that have been added since the 2.1 release, but are missing @since tags. The following API methods were added since 2.1: aboutToRun cancelPressed clearCursors decrementNestingDepth finishedRun getNestingDepth getOpenOnRun incrementNestingDepth open (overrides Window.open) setOpenOnRun
bundles/org.eclipse.jface/src/org/eclipse/jface/dialogs/ProgressMonitorDialog.java
* <p>
 * Typical usage is:
 * <pre>
 * try {
 *    IRunnableWithProgress op = ...;
 *    new ProgressMonitorDialog(activeShell).run(true, true, op);
 * } catch (InvocationTargetException e) {
 *    // handle exception
 * } catch (InterruptedException e) {
 *    // handle cancelation
 * }
 * </pre>
 * </p>
 * <p>
 * Note that the ProgressMonitorDialog is not intended to be used
 * with multiple runnables - this dialog should be discarded
 * after completion of one IRunnableWithProgress and a new one instantiated
 * for use by a second or sebsequent IRunnableWithProgress to ensure
 * proper initialization.
 * </p> 
 * <p>
 * Note that not forking the process will result in it running
 * in the UI which may starve the UI. The most obvious symptom
 * of this problem is non responsiveness of the cancel button.
 * If you are running within the UI Thread you should do the bulk
 * of your work in another Thread to prevent starvation.
 * It is recommended that fork is set to true in most cases.
 * </p>
 */
public class ProgressMonitorDialog extends IconAndMessageDialog implements IRunnableContext {