Bug 178888 [Viewers] JavaDoc errors in GridDataFactory/GridLayoutFactory
There are several javadoc errors in GridDataFactory/GridLayoutFactory. The GridDataFactory class comment contains an "IMPORTANT" comment which was recently rewritten to add javadoc tags... however the meaning was changed subtly and now it warns the user against doing something that is perfectly valid. The GridLayoutFactory Javadoc still references the old name for the extendedMargins method.
bundles/org.eclipse.jface/src/org/eclipse/jface/layout/GridDataFactory.java
* 
     * @see GridLayoutFactory#generateLayout(org.eclipse.swt.widgets.Composite)
     * @param theControl
     * @param hSpan number of columns spanned by the control
     * @param vSpan number of rows spanned by the control
     * @since 3.3
     */
    public static void generate(Control theControl, int hSpan, int vSpan) {
    	defaultsFor(theControl).span(hSpan, vSpan).applyTo(theControl);
    }
    /**
     * Generates layout data to the given control, given the number of cells
     * spanned by the control. Attaches GridData to the control. This method 
     * allows generated layout data to be used with controls that span multiple cells. 
     * <p>
     * The generated layout data is the same as what would be generated by 
     * GridLayoutFactory.generateLayout, except that the span is configurable
     * </p>  
     * 
     * @see GridLayoutFactory#generateLayout(org.eclipse.swt.widgets.Composite)
     * @param theControl
     * @param span The x coordinate indicates the number of
     * columns spanned, and the y coordinate indicates the number of rows.
     * @since 3.3
     */
    public static void generate(Control theControl, Point span) {
    	defaultsFor(theControl).span(span).applyTo(theControl);
    }
    
    /**