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
import org.eclipse.swt.graphics.Point;
import org.eclipse.swt.layout.GridData;
import org.eclipse.swt.layout.GridLayout;
import org.eclipse.swt.widgets.Button;
import org.eclipse.swt.widgets.Composite;
import org.eclipse.swt.widgets.Control;
import org.eclipse.swt.widgets.Event;
import org.eclipse.swt.widgets.Label;
/**
 * Abstract base implementation for all preference page implementations.
 * <p>
 * Subclasses must implement the <code>createControl</code> framework
 * method to supply the page's main control.
 * </p>
 * <p>
 * Subclasses should extend the <code>doComputeSize</code> framework
 * method to compute the size of the page's control.
 * </p>
 * <p>
 * Subclasses may override the <code>performOk</code>, <code>performApply</code>, 
 * <code>performDefaults</code>, <code>performCancel</code>, and <code>performHelp</code>
 * framework methods to react to the standard button events.
 * </p>
 * <p>
 * Subclasses may call the <code>noDefaultAndApplyButton</code> framework
 * method before the page's control has been created to suppress
 * the standard Apply and Defaults buttons.
 * </p>
 */
public abstract class PreferencePage extends DialogPage implements