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
* Returns the nesting depth of running operations.
     * 
     * @return the nesting depth of running operations
     * @since 3.0
     */
    protected int getNestingDepth() {
        return nestingDepth;
    }
    /**
     * Increments the nesting depth of running operations.
     * 
     * @since 3.0
     */
    protected void incrementNestingDepth() {
        nestingDepth++;
    }
    /**
     * Decrements the nesting depth of running operations.
     * 
     * @since 3.0
     *  
     */
    protected void decrementNestingDepth() {
        nestingDepth--;
    }
    /**
     * Called just before the operation is run. Default behaviour is to open or
     * create the dialog, based on the setting of <code>getOpenOnRun</code>,
     * and increment the nesting depth.
     *