Bug 161848 [JFace] Javadoc quality in org.eclipse.jface
As Tod announced on the platform-ui mailing list he wants to set the compiler settings to stricter mode so to ensure the javadoc quality. Because the weather was so lousy in Austria today I tried it and took the effort (~2 hours). I'll attach the patches package wise. This is a starting point.
bundles/org.eclipse.jface/src/org/eclipse/jface/dialogs/ProgressMonitorDialog.java
if (shell != null && !shell.isDisposed()) {
            shell.setCursor(null);
        }
        if (arrowCursor != null) {
			arrowCursor.dispose();
		}
        if (waitCursor != null) {
			waitCursor.dispose();
		}
        arrowCursor = null;
        waitCursor = null;
    }
    /*
     * (non-Javadoc) Method declared in Window.
     */
    protected void configureShell(final Shell shell) {
        super.configureShell(shell);
        shell.setText(JFaceResources.getString("ProgressMonitorDialog.title")); 
        if (waitCursor == null) {
			waitCursor = new Cursor(shell.getDisplay(), SWT.CURSOR_WAIT);
		}
        shell.setCursor(waitCursor);
        
        shell.addListener(SWT.Show, new Listener() {
			public void handleEvent(Event event) {
				setMessage(message);
			}
		
		});
    }