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/layout/LayoutGenerator.java
* @param toGenerate
     *            composite to generate a layout for
     * @param columns
     *            number of columns for the layout
     */
    public static void generateLayout(Composite toGenerate) {
        Control[] children = toGenerate.getChildren();
        for (int i = 0; i < children.length; i++) {
            Control control = children[i];
            
            if (control.getLayoutData() != null) {
                continue;
            }
            applyLayoutDataTo(control);
        }
    }
    private static void applyLayoutDataTo(Control control) {
    	defaultsFor(control).applyTo(control);
    }
    
    public static GridDataFactory defaultsFor(Control control) {
        if (control instanceof Button) {
            Button button = (Button) control;
            if (hasStyle(button, SWT.CHECK)) {
                return nonWrappingLabelData.copy();
            } else {
                return GridDataFactory.fillDefaults().align(SWT.FILL, SWT.CENTER).hint(Geometry.max(button.computeSize(SWT.DEFAULT, SWT.DEFAULT, true), LayoutConstants.getMinButtonSize()));
            }
        }
        if (control instanceof Scrollable) {