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/viewers/DialogCellEditor.java
/**
     * Image registry key for three dot image (value <code>"cell_editor_dots_button_image"</code>).
     */
    public static final String CELL_EDITOR_IMG_DOTS_BUTTON = "cell_editor_dots_button_image";
    /**
     * The editor control.
     */
    private Composite editor;
    /**
     * The current contents.
     */
    private Control contents;
    /**
     * The label that gets reused by <code>updateLabel</code>.
     */
    private Label defaultLabel;
    /**
     * The button.
     */
    private Button button;
	/**
	 * Listens for 'focusLost' events and  fires the 'apply' event as long
	 * as the focus wasn't lost because the dialog was opened.
	 */
	private FocusListener buttonFocusListener;
    /**
     * The value of this cell editor; initially <code>null</code>.
     */
    private Object value = null;