Bug 48400 [Dialogs] MessageDialog needs javadoc for returnCode == -1
org.eclipse.jface.dialogs.MessageDialog extends handleShellCloseEvent() and sets a returnCode of -1 when the dialog is closed without pressing a button (pressed esc key or clicked close box). This special returnCode needs to be commented in JavaDocs, since it is an unexpected result (and already caused problems). I suggest to ... - transform the comment for handleShellCloseEvent() into a JavaDoc comment - replace '-1' by SWT.DEFAULT or a new 'public static final int' constant - mention the special returnCode in MessageDialog's class JavaDoc
bundles/org.eclipse.jface/src/org/eclipse/jface/dialogs/MessageDialog.java
* 	Constant for a dialog with an info image (value 2).
	 */
	public final static int INFORMATION = 2;
	/**
	 * 	Constant for a dialog with a question image (value 3).
	 */
	public final static int QUESTION = 3;
	/**
	 * 	Constant for a dialog with a warning image (value 4).
	 */
	public final static int WARNING = 4;
	/**
	 * Labels for buttons in the button bar (localized strings).
	 */
	private String[] buttonLabels;
	/**
	 * The buttons. Parallels <code>buttonLabels</code>.
	 */
	private Button[] buttons;
	/**
	 * Index into <code>buttonLabels</code> of the default button.
	 */
	private int defaultButtonIndex;
	/**
	 * Dialog title (a localized string).
	 */
	private String title;
	/**
	 * Dialog title image.
	 */