Bug 233313 [Preferences] Mistake in javadoc for PreferencePage
Build ID: M20080221-1800 Steps To Reproduce: Open source code for org.eclipse.jface.preference.PreferencePage. The javadoc of the PreferencePage states that: "Subclasses must implement the createControl framework method to supply the page's main control." I think this should be "Subclasses must implement the _createContents_ framework method to supply the page's main control." More information: Because createControl is inherited from DialogPage and implements buttons and decoration. The method then calls the abstract createContents that people use to fill out the preference page with SWT controls.
bundles/org.eclipse.jface/src/org/eclipse/jface/preference/PreferencePage.java
* Subclasses wishing a preference page without these buttons
     * should call this framework method before the page's control
     * has been created.
     * </p>
     */
    protected void noDefaultAndApplyButton() {
        createDefaultAndApplyButton = false;
    }
    /**
     * The <code>PreferencePage</code> implementation of this 
     * <code>IPreferencePage</code> method returns <code>true</code>
     * if the page is valid.
     * @see IPreferencePage#okToLeave()
     */
    public boolean okToLeave() {
        return isValid();
    }
    /**
     * Performs special processing when this page's Apply button has been pressed.
     * <p>
     * This is a framework hook method for sublcasses to do special things when
     * the Apply button has been pressed.
     * The default implementation of this framework method simply calls
     * <code>performOk</code> to simulate the pressing of the page's OK button.
     * </p>
     * 
     * @see #performOk
     */
    protected void performApply() {
        performOk();