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/preference/PreferenceDialog.java
*/
	private Composite pageContainer;
	/**
	 * The preference manager.
	 */
	private PreferenceManager preferenceManager;
	/**
	 * Flag for the presence of the error message.
	 */
	private boolean showingError = false;
	/**
	 * Preference store, initially <code>null</code> meaning none.
	 * 
	 * @see #setPreferenceStore
	 */
	private IPreferenceStore preferenceStore;
	private Composite titleArea;
	/**
	 * The tree viewer.
	 */
	private TreeViewer treeViewer;
	
    private ListenerList pageChangedListeners = new ListenerList();
    /**
     *  Composite with a FormLayout to contain the title area
     */
    Composite formTitleComposite;
	/**
	 * Creates a new preference dialog under the control of the given preference
	 * manager.