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/action/ActionContributionItem.java
return action != null && action.isEnabled();
    }
    /**
     * Returns <code>true</code> if this item is allowed to enable,
     * <code>false</code> otherwise.
     * 
     * @return if this item is allowed to be enabled
     * @since 2.0
     */
    protected boolean isEnabledAllowed() {
        if (getParent() == null) {
			return true;
		}
        Boolean value = getParent().getOverrides().getEnabled(this);
        return (value == null) ? true : value.booleanValue();
    }
    /**
     * The <code>ActionContributionItem</code> implementation of this 
     * <code>ContributionItem</code> method extends the super implementation
     * by also checking whether the command corresponding to this action is active.
     */
    public boolean isVisible() {
        return super.isVisible() && isCommandActive();
    }
    /**
     * Sets the presentation mode, which is the bitwise-or of the 
     * <code>MODE_*</code> constants.
     * 
     * @param mode the presentation mode settings
     *