<li><a href="#requirements">Requirements</a></li>
</ul>
-<p>Vaadin @version@ is an update release for Vaadin 6. In addition to various fixes, it
-contains a number of significant enhancements.</p>
+<p>Vaadin @version@ is a maintenance release for Vaadin 6.2,
+containing a number of important fixes. These are listed in the <a
+ href="#changelog">Change Log</a> below</p>
-<ul>
- <li>Widget set definition and component-to-widget mapping has been redesigned</li>
- <ul>
- <li>Reuse of widgets is now much easier, as it is easier to package and use widget
- set JARs and otherwise combine widget sets.</li>
-
- <li>A widget set definition class is no longer used. The Java
- code needed for widget instantiation and client-server mapping is now
- automatically generated by the GWT compiler. For the basic Vaadin
- user, a widget set is now defined only in a GWT module definition file
- (<tt>.gwt.xml</tt>).</li>
-
- <li>Server-side component is mapped to a client-side widget with an annotation:
- <pre>@ClientWidget(com.vaadin.demo.colorpicker.gwt.client.ui.VColorPicker.class)
-public class ColorPicker extends AbstractField {</pre>
- </li>
-
- <li>The <tt>getTag()</tt> method is no longer needed</tt></li>
-
- <li>The Vaadin Plugin for Eclipse can create new widget stubs, define the mapping,
- and create widget set definition files (<tt>.gwt.xml</tt>).</li>
-
- <li>See <tt>WebContent/docs/example-source/build-widgetset.xml</tt> for an example
- on how you can compile widget sets and widget set JARs with Ant.</li>
-
- <li>A widget set builder allows automatic generation and maintenance of widget
- configurations, making use of widget set JARs easier.</li>
-
- <li>See <a href="#widgetupgrade">notes below</a> for upgrading widget set
- definitions and widget mappings from earlier version of Vaadin 6.</li>
- </ul>
- <li>Other enhancements to development of new components</li>
- <ul>
- <li>On the server-side:</li>
- <ul>
- <li>Listeners for custom client side events are now easier to implement with
- <tt>ReflectTools.findMethod()</tt> and <tt>addListener(String eventIdentifier,
- Class<?> eventType, Object target, Method method)</tt> methods. The latter
- automatically informs the client-side that a listener is registered on server side)</li>
- </ul>
- <li>On the client-side:</li>
- <ul>
- <li>Ability to check if a listener is registered on the server-side</li>
- <li>Typed arrays and maps can now be sent to server with <tt>updateVariable()</tt>
- <ul>
- <li><b>Note!</b> This change affects existing custom components that send object arrays to the server.
- Previously, an <tt>Object[]</tt> sent from client to server was converted into <tt>String[]</tt> on the server-side.
- This invalid behavior is now fixed and an <tt>Object[]</tt> sent from client-side is an
- <tt>Object[]</tt> on the server-side.</li>
- </ul>
- </li>
- </ul>
- </ul>
- <li>Portlet 2.0 (JSR 268) support</li>
- <ul>
- <li>A separate servlet for each portlet is no longer needed.
- (no separate servlet, no session problems, portlet-to-portlet communication, etc)</li>
- </ul>
- <li>OSGi support</li>
- <ul>
- <li>Vaadin now works as a OSGi bundle.</li>
- </ul>
- <li>Enhanced sorting of <b>IndexedContainer</b> and <b>BeanItemContainer</b></li>
- <ul>
- <li>Custom sort methods can now be used to sort container contents.</li>
- </ul>
- <li>Improved event support</li>
- <ul>
- <li>Client-side events are sent to the server only when a listener has been registered for the event</li>
- <li>All built-in layouts (<b>AbsoluteLayout</b>, <b>CssLayout</b>, <b>HorizontalLayout</b>, <b>GridLayout</b>, and <b>VerticalLayout</b>) now support click listeners.</li>
- <li>Click events for <b>Panel</b> and <b>Embedded</b>.</li>
- <li>Focus and blur events for <b>DateField</b>, <b>TextField</b>, and <b>Select</b></li>
- </ul>
- <li>JavaScript execution with <tt>Window.excecuteJavaScript()</tt></li>
- <ul>
- <li>You can execute JavaScript directly from the server-side with the new <tt>excecuteJavaScript()</tt> method. You can use it, for example, for integration with other systems or for implementing print functionality (<tt>window.print()</tt>). </li>
- </ul>
- <li>Additional Maven archetypes</li>
- <ul>
- <li><b>vaadin-archetype-clean</b> with a dependency to Vaadin and a minimal application skeleton, no client-side widgets</li>
- <li><b>vaadin-archetype-widget</b> for creation of Vaadin 6.2 widget packages</li>
- <li><b>vaadin-archetype-sample</b> has been updated for Vaadin 6.2 - use version 1.0.x for earlier versions of Vaadin</li>
- </ul>
- <li>Maven Vaadin plugin</li>
- <ul>
- <li><b>vaadin-maven-plugin</b> can automatically update Vaadin 6.2 widget sets based on Maven dependencies using the goal <tt>update-widgetset</tt></li>
- </ul>
- <li><b>HttpServletRequestListener</b></li>
- <ul>
- <li>Similar to <b>TransactionListener</b>, but only related to a single Application. Called before and after every servlet request and provides access to <b>HttpServletRequest</b> and <b>HttpServletResponse</b>.</li>
- </ul>
- <li><b>PortletRequestListener</b>
- <ul>
- <li>Similar to <b>HttpServletRequestListener</b>, but for portlets. Called before and after every portlet request and provides access to <b>PortletRequest</b> and <b>PortletResponse</b>.</li>
- </ul>
- <li>Enhancements to various components:</li>
- <ul>
- <li><b>Window</b>: Additional control over a sub-window: close and drag prevention.</li>
- <li><b>Tree</b>: Item style generator enabling styling of individual tree items. Rendering optimizations.</li>
- <li><b>Tabsheet</b>: Tabs can be marked as closable. The new <b>CloseHandler</b> can be used to ask for confirmation, prevent closing etc.</li>
- <li><b>SplitPanel</b>: Double-clicking the splitter sends an event which can be handled on server-side.</li>
- <li><b>MenuBar</b>: Many enhancements: individual items can be styled, support for separators, disabling of items, visibility of items.</li>
- <li><b>DateField</b>: Support for lenient/non-lenient mode. A <b>DateField</b> is now by default in non-lenient mode (only accepts valid dates). </li>
- </ul>
- <li>Automatic integration tests</li>
- <ul>
- <li>All Vaadin builds are now automatically tested on all supported servers.</li>
- </ul>
- <li>Dozens of other small enhancements and bug fixes</li>
-</ul>
+<p>For recent major enhancements, see the <a
+ href="http://vaadin.com/download/release/6.2/6.2.0/release-notes.html">Release
+Notes for Vaadin 6.2.0</a>.</p>
<p>Problem fixes and enhancements planned for upcoming releases can be found from the <a
href="http://dev.vaadin.com/roadmap">Vaadin Roadmap</a> in Vaadin Trac.</p>
6.2.0, notice that Vaadin 6.2 uses GWT 1.7.0 (included in the installation package). See
<a href="#upgrading">General Upgrade Notes</a> for more details on upgrading.</p>
+<h2><a name="changelog">Change Log</a></h2>
+
+<p>The following closed issues have been included in this release:</p>
+
+<ul>
+ <li><a href="http://dev.vaadin.com/ticket/1211">#1211</a>: ISlider: Provide proper feedback (current value) to user when moving handle</li>
+ <li><a href="http://dev.vaadin.com/ticket/3607">#3607</a>: Component Already Has A Parent. This exception should be detailed</li>
+ <li><a href="http://dev.vaadin.com/ticket/3617">#3617</a>: NullPointerException in IndexedContainer.removeItem()</li>
+ <li><a href="http://dev.vaadin.com/ticket/3764">#3764</a>: (Safari) Vertical scrolling in Table is broken when horizontal scrolling is used</li>
+ <li><a href="http://dev.vaadin.com/ticket/3793">#3793</a>: VScrollTable adds horizontal scrollbar on top of rows</li>
+ <li><a href="http://dev.vaadin.com/ticket/3799">#3799</a>: column autoresizing doesn't seem to work anymore</li>
+ <li><a href="http://dev.vaadin.com/ticket/3803">#3803</a>: Better description for GridLayout's OverlapsException</li>
+ <li><a href="http://dev.vaadin.com/ticket/3814">#3814</a>: Table does not render last row in a container when in 100% height</li>
+ <li><a href="http://dev.vaadin.com/ticket/3826">#3826</a>: Table breaks (white area) when container property value is changed (SA, FF)</li>
+ <li><a href="http://dev.vaadin.com/ticket/3832">#3832</a>: Include widget class in missing widget warning message</li>
+ <li><a href="http://dev.vaadin.com/ticket/3840">#3840</a>: setDebugId does not set ID's on hidden fields</li>
+ <li><a href="http://dev.vaadin.com/ticket/3875">#3875</a>: Webkit rendering bug causes whitespace between header and first row in table</li>
+ <li><a href="http://dev.vaadin.com/ticket/3882">#3882</a>: Top of a tooltip (or error in tooltip) is not visible</li>
+ <li><a href="http://dev.vaadin.com/ticket/3889">#3889</a>: Multiple new samples use main window instead of current window</li>
+ <li><a href="http://dev.vaadin.com/ticket/3893">#3893</a>: ProgressIndicator sample should synchronize UI updates using the application</li>
+ <li><a href="http://dev.vaadin.com/ticket/3901">#3901</a>: Checkbox - In IE7 the outline focuses around the caption, rather than around the input component</li>
+ <li><a href="http://dev.vaadin.com/ticket/3902">#3902</a>: VWindow focus handling broken</li>
+ <li><a href="http://dev.vaadin.com/ticket/3904">#3904</a>: VSplitPanel sends unnecessary split position events</li>
+ <li><a href="http://dev.vaadin.com/ticket/3907">#3907</a>: Undefined wide MenuBar will drop items that do not fit in view</li>
+ <li><a href="http://dev.vaadin.com/ticket/3908">#3908</a>: MenuBar doesn't open sub-submenus with hover in IE7</li>
+ <li><a href="http://dev.vaadin.com/ticket/3919">#3919</a>: Create integration tests for Glassfish v3</li>
+ <li><a href="http://dev.vaadin.com/ticket/3920">#3920</a>: Glassfish v3 does not work with Vaadin</li>
+</ul>
+
<h2><a name="widgetupgrade">Upgrading from an Earlier Version of Vaadin 6</a></h2>
<p>
<p>For other known problems, see open tickets at developer site <a
href="http://dev.vaadin.com/">dev.vaadin.com</a>.</p>
-<h2><a name="changelog">Change Log</a></h2>
-
-<p>The following closed issues have been included in this release:</p>
-
-<ul>
-<li><a href="http://dev.vaadin.com/ticket/1595">#1595</a>: Close button on TabSheet control</li>
-<li><a href="http://dev.vaadin.com/ticket/2594">#2594</a>: Add support for native JSON evaluation in UIDL parsing</li>
-<li><a href="http://dev.vaadin.com/ticket/2632">#2632</a>: Notifications should not be wider than the screen</li>
-<li><a href="http://dev.vaadin.com/ticket/2821">#2821</a>: Sumbenu icon is not aligned with the menu item's text</li>
-<li><a href="http://dev.vaadin.com/ticket/2849">#2849</a>: Deprecate MenuBar.setSubmenuIcon method, and provide the same functionality via CSS</li>
-<li><a href="http://dev.vaadin.com/ticket/2854">#2854</a>: Paintable should be an appropriate variable type</li>
-<li><a href="http://dev.vaadin.com/ticket/2918">#2918</a>: Same application is loaded in different portlet instances</li>
-<li><a href="http://dev.vaadin.com/ticket/3070">#3070</a>: Tree's Items should be easily styled</li>
-<li><a href="http://dev.vaadin.com/ticket/3088">#3088</a>: ComboBox, If only one item is listed, pressing Enter should choose it, not discard</li>
-<li><a href="http://dev.vaadin.com/ticket/3117">#3117</a>: Portlet 2.0 (JSR-286) support</li>
-<li><a href="http://dev.vaadin.com/ticket/3120">#3120</a>: Window.setClosable(boolean)</li>
-<li><a href="http://dev.vaadin.com/ticket/3133">#3133</a>: Window draggability disabling feature</li>
-<li><a href="http://dev.vaadin.com/ticket/3175">#3175</a>: Date Field "too big" date handling</li>
-<li><a href="http://dev.vaadin.com/ticket/3185">#3185</a>: Add possibility to specify application CSS class name (Patch to make it easier to use Vaadin with Jython)</li>
-<li><a href="http://dev.vaadin.com/ticket/3230">#3230</a>: Sub window should not be dragged or resized when the cursor is outside the browser window</li>
-<li><a href="http://dev.vaadin.com/ticket/3234">#3234</a>: Component Event Listener Framework for all widgets/components</li>
-<li><a href="http://dev.vaadin.com/ticket/3259">#3259</a>: Removing all action handlers</li>
-<li><a href="http://dev.vaadin.com/ticket/3277">#3277</a>: MenuBar.MenuItem could have setVisible() method</li>
-<li><a href="http://dev.vaadin.com/ticket/3298">#3298</a>: Split sources to several folders</li>
-<li><a href="http://dev.vaadin.com/ticket/3332">#3332</a>: Redesign how widgets are packaged and how the widgetset is built</li>
-<li><a href="http://dev.vaadin.com/ticket/3338">#3338</a>: Create a Maven archetype for creating a widget project</li>
-<li><a href="http://dev.vaadin.com/ticket/3367">#3367</a>: It should be possible to specify parameters for embedded flash</li>
-<li><a href="http://dev.vaadin.com/ticket/3416">#3416</a>: Theme should contain Vaadin version</li>
-<li><a href="http://dev.vaadin.com/ticket/3433">#3433</a>: BeanItemContainer's sort is not overridable</li>
-<li><a href="http://dev.vaadin.com/ticket/3434">#3434</a>: IndexedContainer's compare is not overridable</li>
-<li><a href="http://dev.vaadin.com/ticket/3451">#3451</a>: ComboBox causes internal error when changing page too fast</li>
-<li><a href="http://dev.vaadin.com/ticket/3472">#3472</a>: Give better error message if widgetset can not be loaded</li>
-<li><a href="http://dev.vaadin.com/ticket/3473">#3473</a>: Detect if UIDL request returns 404 and show an error message</li>
-<li><a href="http://dev.vaadin.com/ticket/3479">#3479</a>: Embedded applications should not change the page title</li>
-<li><a href="http://dev.vaadin.com/ticket/3483">#3483</a>: PopupView rendering style inside a layout is unspecified</li>
-<li><a href="http://dev.vaadin.com/ticket/3498">#3498</a>: Window doesn't get focus correctly</li>
-<li><a href="http://dev.vaadin.com/ticket/3499">#3499</a>: PopupView CSS style is broken</li>
-<li><a href="http://dev.vaadin.com/ticket/3526">#3526</a>: SplitPanel collapse and expand with doubleclick</li>
-<li><a href="http://dev.vaadin.com/ticket/3541">#3541</a>: VerticalLayout//HorizontalLayout/GridLayout/AbsoluteLayout/CSSLayout should support click events</li>
-<li><a href="http://dev.vaadin.com/ticket/3544">#3544</a>: Implement support for focus/blur events in TextField</li>
-<li><a href="http://dev.vaadin.com/ticket/3565">#3565</a>: CommunicationManager is not serializable</li>
-<li><a href="http://dev.vaadin.com/ticket/3580">#3580</a>: MenuBar stylenames aren't added to the submenu overlays</li>
-<li><a href="http://dev.vaadin.com/ticket/3589">#3589</a>: Window.executeJavaScript()</li>
-<li><a href="http://dev.vaadin.com/ticket/3603">#3603</a>: No DTD in generated GWT descriptor</li>
-<li><a href="http://dev.vaadin.com/ticket/3605">#3605</a>: Patch to avoid concurrent modification exceptions in EventRouter</li>
-<li><a href="http://dev.vaadin.com/ticket/3631">#3631</a>: LoginForm login button is too wide in IE6/IE7</li>
-<li><a href="http://dev.vaadin.com/ticket/3654">#3654</a>: Decide on final PaintTarget.paintReference(Paintable, String) API</li>
-<li><a href="http://dev.vaadin.com/ticket/3655">#3655</a>: ApplicationRunner logs unnecessary java.lang.ClassNotFoundExceptions</li>
-<li><a href="http://dev.vaadin.com/ticket/3678">#3678</a>: MenuBar needs a separator item</li>
-<li><a href="http://dev.vaadin.com/ticket/3683">#3683</a>: TextField.setRows() API needs reworking</li>
-<li><a href="http://dev.vaadin.com/ticket/3688">#3688</a>: ContainerHierarchicalWrapper should stay ordered by the wrapped container</li>
-<li><a href="http://dev.vaadin.com/ticket/3715">#3715</a>: Sub windows are shown as VView in debug console</li>
-<li><a href="http://dev.vaadin.com/ticket/3717">#3717</a>: Parameterize BeanItem and ComponentContainer.getComponentIterator</li>
-<li><a href="http://dev.vaadin.com/ticket/3721">#3721</a>: ComboBox can insert only new item without losing its focus</li>
-<li><a href="http://dev.vaadin.com/ticket/3731">#3731</a>: Implement a simpler alternative to ApplicationContext.TransactionListener</li>
-<li><a href="http://dev.vaadin.com/ticket/3740">#3740</a>: Tabsheet no longer fully serializable, doesn't work in GAE</li>
-<li><a href="http://dev.vaadin.com/ticket/3754">#3754</a>: Add data.util.TextFileProperty</li>
-<li><a href="http://dev.vaadin.com/ticket/3755">#3755</a>: Select throws IllegalArgumentException when browsing pages quickly</li>
-<li><a href="http://dev.vaadin.com/ticket/3756">#3756</a>: Add support for passing a typed Object[] from client to server</li>
-<li><a href="http://dev.vaadin.com/ticket/3757">#3757</a>: Add support for passing a typed map from client to server</li>
-<li><a href="http://dev.vaadin.com/ticket/3759">#3759</a>: Cannot scroll to the last tab in a Tabsheet</li>
-<li><a href="http://dev.vaadin.com/ticket/3760">#3760</a>: Scrollbars are missing in Safari/Chrome</li>
-<li><a href="http://dev.vaadin.com/ticket/3761">#3761</a>: MenuBar breaks the application completely</li>
-<li><a href="http://dev.vaadin.com/ticket/3762">#3762</a>: Dependency to javax/portlet/PortletRequest, won't work with GAE</li>
-<li><a href="http://dev.vaadin.com/ticket/3763">#3763</a>: Add javadoc to public methods in ApplicationConnection</li>
-<li><a href="http://dev.vaadin.com/ticket/3772">#3772</a>: Add notifier interfaces for focus and blur events</li>
-<li><a href="http://dev.vaadin.com/ticket/3775">#3775</a>: Optimize Tree rendering</li>
-<li><a href="http://dev.vaadin.com/ticket/3782">#3782</a>: ClassCastException when adding Window via addComponent</li>
-<li><a href="http://dev.vaadin.com/ticket/3783">#3783</a>: ClickListener in Panel does not work</li>
-<li><a href="http://dev.vaadin.com/ticket/3784">#3784</a>: Panel.setScrollTop does not work with invalid values</li>
-<li><a href="http://dev.vaadin.com/ticket/3785">#3785</a>: Style names for MenuBar.MenuItem</li>
-<li><a href="http://dev.vaadin.com/ticket/3786">#3786</a>: Add focus and blur events to Select/VFilterSelect and DateField/VTextualDate</li>
-<li><a href="http://dev.vaadin.com/ticket/3788">#3788</a>: Typo in setWriteThrough's parameter name</li>
-<li><a href="http://dev.vaadin.com/ticket/3807">#3807</a>: LoginForm doesn't work when multiple windows are used for the same application</li>
-<li><a href="http://dev.vaadin.com/ticket/3817">#3817</a>: Upload: Browsers send different filenames</li>
-<li><a href="http://dev.vaadin.com/ticket/3819">#3819</a>: Document that widgetset compiler loads classes</li>
-<li><a href="http://dev.vaadin.com/ticket/3820">#3820</a>: DefaultItemSorter is not serializable</li>
-<li><a href="http://dev.vaadin.com/ticket/3824">#3824</a>: Make sure build generates theme version</li>
-<li><a href="http://dev.vaadin.com/ticket/3825">#3825</a>: AbstractComponentThrows NPE when both visible and enable is set to false</li>
-<li><a href="http://dev.vaadin.com/ticket/3828">#3828</a>: TextField inside a layout inside a Table is clipped</li>
-<li><a href="http://dev.vaadin.com/ticket/3835">#3835</a>: Portlet 2.0 does not support the "style" parameter</li>
-<li><a href="http://dev.vaadin.com/ticket/3843">#3843</a>: Form caption is blue in IE</li>
-<li><a href="http://dev.vaadin.com/ticket/3845">#3845</a>: Twincol select buttons are missing right border in IE6</li>
-<li><a href="http://dev.vaadin.com/ticket/3849">#3849</a>: Undefined wide menubar is 100% wide in IE6</li>
-<li><a href="http://dev.vaadin.com/ticket/3850">#3850</a>: Submenu icon is placed outside the menu in IE7</li>
-<li><a href="http://dev.vaadin.com/ticket/3859">#3859</a>: Application contains mysterious deprecated methods</li>
-<li><a href="http://dev.vaadin.com/ticket/3874">#3874</a>: Two click events is sent for a middle click in a layout</li>
-<li><a href="http://dev.vaadin.com/ticket/3879">#3879</a>: Removing portlet leaks memory</li>
-<li><a href="http://dev.vaadin.com/ticket/3881">#3881</a>: MenuBar collapsing slightly broken with Reindeer theme</li>
-<li><a href="http://dev.vaadin.com/ticket/3883">#3883</a>: Extra white space at top when navigating in sampler with IE8</li>
-<li><a href="http://dev.vaadin.com/ticket/3884">#3884</a>: Menubar with collapsed menus does not handle resize events properly</li>
-<li><a href="http://dev.vaadin.com/ticket/3885">#3885</a>: Menubar with collapsed menus does not show arrow for showing collapsed items</li>
-<li><a href="http://dev.vaadin.com/ticket/3886">#3886</a>: InputPrompt of TextField/Combobox does not change until refresh</li>
-</ul>
-
<h2><a name="requirements">Requirements</a></h2>
<p>Vaadin is available for the following operating systems:</p>