Updated Release Notes for Vaadin 6.2.

svn changeset:10406/svn branch:6.2
author: Marko Grönroos <magi@iki.fi> 2009-12-18 07:35:02 +0000
committer: Marko Grönroos <magi@iki.fi> 2009-12-18 07:35:02 +0000
commit: 957b923bf48cd135338c51bd3d651a80fd6f4b4f (patch)
tree: a6b074f99ecdac261adc00b59db9416a818e1e7e /WebContent/release-notes.html
parent: e52158d8424342cdaa0c2f670b940f4d9890dc00 (diff)
download: vaadin-framework-957b923bf48cd135338c51bd3d651a80fd6f4b4f.tar.gz
vaadin-framework-957b923bf48cd135338c51bd3d651a80fd6f4b4f.zip
1 files changed, 132 insertions, 24 deletions
diff --git a/WebContent/release-notes.html b/WebContent/release-notes.html
index e932365908..6825e8bb4e 100644
--- a/WebContent/release-notes.html
+++ b/WebContent/release-notes.html
@@ -1,4 +1,5 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
@@ -33,29 +34,38 @@
   <li><a href="#requirements">Requirements</a></li>
 </ul>
 
-<p><i><b>This is a prerelease version of Vaadin 6.2</b>, the Release
-Notes will change before the final release.</i> Also notice that the regular
-Vaadin Plugin for Eclipse does not support Vaadin 6.2 yet; you should
-use <tt>http://vaadin.com/eclipse/experimental</tt> as the URL for the
-experimental plugin that supports the upcoming Vaadin 6.2.</p>
-
-<p>Vaadin @version@ is an update for Vaadin 6. In addition to various fixes, it
+<p>Vaadin @version@ is an update release for Vaadin 6. In addition to various fixes, it
 contains a number of significant enhancements.</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. Java code needed for widget instantiation and client-server mapping is 
-        	automatically generated by GWT compiler. For common Vaadin user, Widgetset is now only a GWT module definition file (.gwt.xml).</li>
+        <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. Java code needed for widget
+        instantiation and client-server mapping is automatically generated by GWT
+        compiler. For common Vaadin user, Widgetset is now only a GWT module definition
+        file (.gwt.xml).</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 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>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>
@@ -68,17 +78,34 @@ public class ColorPicker extends AbstractField {</pre>
 		</ul>
         <li>On the client-side:</li>
         <ul>
-            <li>Ability to check if a listener is registered on server side</li>
+            <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></li>
         </ul>
     </ul>
     <li>Refactoring widget sets has also provided some optimizations for rendering</li>
     <li>Portlet 2.0 (JSR 268) support (no separate servlet, no session problems, portlet-to-portlet communication, etc)</li> 
     <li>OSGi support</li>
-    <li>Enhanced sorting of <b>IndexedContainer</b> and <b>BeanItemContainer</b></li>
-    <li>New layout in Sampler and several new examples</li>
+    <li>Enhanced sorting of <b>IndexedContainer</b> and <b>BeanItemContainer</b> [TODO]</li>
+    <li>Improved event support [TODO]</li>
     <li>JavaScript injection with <tt>Window.excecuteJavaScript()</tt>, "the method that you never want to use, but that is nice to have"</li> 
-    <li><b>Tree</b> style generator, <b>TabSheet</b> close button, plus dozens of other small enhancements and bug fixes</li> 
+    <li>Additional Maven archetypes [TODO]</li>
+    <li>New layout in Sampler and several new examples</li>
+    <li><b>HttpServletRequestListener</b> [TODO]</li>
+    <li><b>PortletRequestListener</b> [TODO]</li>
+    <li>Window closable support [TODO]</li>
+    <li>Enhancements to various components:</li>
+    <ul>
+      <li><b>Tree</b>: item style generator, rendering optimizations</li> 
+      <li><b>ItemSorter</b> [TODO]</li>
+      <li><b>Tabsheet</b>: a close button for tabs</li>
+      <li><b>SplitPanel</b>: double-click event for a splitter</li>
+      <li><b>MenuBar</b> enhancements [TODO]</li>
+      <li><b>DateField</b>: lenient/non-lenient support [TODO]</li>
+      <li>Click listeners for <b>Panel</b>, <b>Embedded</b>, and layout components [TODO]</li>
+      <li>Focus and blur events for <b>DateField</b>, <b>TextField</b>, and <b>Select</b> [TODO]</li>
+    </ul>
+    <li>Automatic integration tests for the supported servers</li>
+    <li>Dozens of other small enhancements and bug fixes</li> 
 </ul>
 
 <p>Problem fixes and enhancements planned for upcoming releases can be found from the <a
@@ -86,12 +113,49 @@ href="http://dev.vaadin.com/roadmap">Vaadin Roadmap</a> in Vaadin Trac.</p>
 
 <p>As always, when upgrading from an earlier version, you should recompile any custom
 widget sets and refresh your project in Eclipse. If you are upgrading from earlier than
-6.1.0, notice that Vaadin 6.1 uses GWT 1.7.0 (included in the installation package). See
+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>Widgetset upgrade notes</h2>
+<h2><a name="widgetupgrade">Upgrading Custom Component Projects from Earlier Vaadin 6</a></h2>
+
+<p>If you are using custom components (components from other than the
+<b>DefaultWidgetSet</b>) from an earlier version of Vaadin 6, you will need to upgrade the
+widget set definitions.</p>
 
-See preliminary instructions from <a href="http://dev.vaadin.com/wiki/WidgetSetUpgrade">wiki</a>.
+<p>[TODO]</p>
+
+<ul>
+  <li>If using a widget set from another project (most likely from a separate JAR file):</li>
+  <ul>
+    <li>Get a widget set JAR compatible with Vaadin 6.2. If the new JAR does not contain a
+    precompiled widget set (as it normally does not), you need to create a custom widget
+    set for your project. The experimental eclipse plugin will create it for you
+    automatically.</li>
+  </ul>
+  <li>If the project has its own widget set:
+  <ul>
+     <li>Remove <tt>WidgetSet.java</tt> file, this is no more needed</li>
+     <li>If project has client-side components in its own source directory:</li>
+     <ul>
+       <li>Remove <i>getTag()</i> method implementations from server-side components; tag
+       names are no longer used. We have intentionally made the <i>getTag()</i> method
+       <tt>final</tt> to make it easier to find them (they wont compile)</li>
+
+       <li>Annotate server-side components having client side counterpart with
+       <tt>@ClientWidget(VClientSideCounterPart.class)</tt> annotation. Basically these are the
+       same components that had the <i>getTag()</i> method previously. </li>
+     </ul>
+     <li>If (combined) widget set uses widgets from other widget sets (most likely from a separate JAR file)</li>
+     <ul>
+       <li>Update referenced widget sets to support 6.2</li>
+       <li>Add/keep necessary inherits tags in your combined widgetset (<tt>.gwt.xml</tt> file). Eclipse plugin will again try to automatically add these to your widgetset.</li>
+     </ul>
+     <li>If you package a widget set as a JAR for usage in other projects:</li>
+     <ul>
+       <li>Add an entry like Vaadin-Widgetsets: com.vaadin.incubator.fastlayouts.ws.FastLayoutsWidgetSet to JAR files MANIFEST.MF file. This helps tools to detect package as vaadin component package.</li>
+     </ul>
+  </ul>
+</ul>
 
 <h2><a name="upgrading">General Upgrade Notes</a></h2>
 
@@ -283,26 +347,45 @@ sets with the regular Vaadin package for your platform.</p>
 <p>The following closed issues have been included in this release:</p>
 	
 <ul>
-  <li><a href="http://dev.vaadin.com/ticket/2719">#2719</a>: Sampler margin demo shows wide right margin without explanation</li>
+  <li><a href="http://dev.vaadin.com/ticket/2118">#2118</a>: Sample: ProgressIndicator</li>
+  <li><a href="http://dev.vaadin.com/ticket/2715">#2715</a>: Sample: Slider</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/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/3323">#3323</a>: Redesign sampler main screen</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/3386">#3386</a>: Add JUnit tests for ensuring compatibility with all supported application servers and portals</li>
-  <li><a href="http://dev.vaadin.com/ticket/3387">#3387</a>: Google AppEngine integration test</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/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/3484">#3484</a>: Sample: OptionGroup</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/3515">#3515</a>: Sample: NativeButton</li>
+  <li><a href="http://dev.vaadin.com/ticket/3518">#3518</a>: Sample: Menubar</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/3553">#3553</a>: Change nightly and develpoment version numbering</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/3640">#3640</a>: Update build-widgetsets.xml and verify it works</li>
+  <li><a href="http://dev.vaadin.com/ticket/3641">#3641</a>: Document the way widgets and widgetsets are created and used in Vaadin 6.2</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/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/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>
@@ -320,7 +403,32 @@ sets with the regular Vaadin package for your platform.</p>
   <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/3787">#3787</a>: validator is not called when field is empty and not required</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/3809">#3809</a>: Sample: Immediate upload</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/3830">#3830</a>: Group widgetset builder output</li>
+  <li><a href="http://dev.vaadin.com/ticket/3831">#3831</a>: Show better information about what widget is missing</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/3842">#3842</a>: Make widgetset generation console output parameterized</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/3848">#3848</a>: Rich text sample is cut in IE</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/3853">#3853</a>: Sampler fragments should be backwards compatible</li>
+  <li><a href="http://dev.vaadin.com/ticket/3856">#3856</a>: Add javadoc to UIDL class</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/3862">#3862</a>: JSApi sample uses threads</li>
+  <li><a href="http://dev.vaadin.com/ticket/3872">#3872</a>: Remove reservr from demo page</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>
 </ul>	
 
 <h2><a name="requirements">Requirements</a></h2>
author	Marko Grönroos <magi@iki.fi>	2009-12-18 07:35:02 +0000
committer	Marko Grönroos <magi@iki.fi>	2009-12-18 07:35:02 +0000
commit	957b923bf48cd135338c51bd3d651a80fd6f4b4f (patch)
tree	a6b074f99ecdac261adc00b59db9416a818e1e7e /WebContent/release-notes.html
parent	e52158d8424342cdaa0c2f670b940f4d9890dc00 (diff)
download	vaadin-framework-957b923bf48cd135338c51bd3d651a80fd6f4b4f.tar.gz vaadin-framework-957b923bf48cd135338c51bd3d651a80fd6f4b4f.zip