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
/*******************************************************************************
 * Copyright (c) 2000, 2007 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 * 	   Sebastian Davids <sdavids@gmx.de> - Fix for bug 38729 - [Preferences]
 * 			 NPE PreferencePage isValid.
 *******************************************************************************/
package org.eclipse.jface.preference;
import org.eclipse.jface.dialogs.Dialog;
import org.eclipse.jface.dialogs.DialogPage;
import org.eclipse.jface.dialogs.IDialogConstants;
import org.eclipse.jface.dialogs.IDialogPage;
import org.eclipse.jface.resource.ImageDescriptor;
import org.eclipse.jface.resource.JFaceResources;
import org.eclipse.jface.util.IPropertyChangeListener;
import org.eclipse.jface.util.PropertyChangeEvent;
import org.eclipse.swt.SWT;
import org.eclipse.swt.events.DisposeEvent;
import org.eclipse.swt.events.DisposeListener;
import org.eclipse.swt.events.SelectionAdapter;
import org.eclipse.swt.events.SelectionEvent;
import org.eclipse.swt.graphics.Font;