From 3fb9e26a5cf632723d646e5d72e343b9751d08fa Mon Sep 17 00:00:00 2001 From: =?utf8?q?Marko=20Gr=C3=B6nroos?= Date: Tue, 3 May 2011 16:55:45 +0000 Subject: [PATCH] Updated upgrading instructions in Release Notes and mentioned GWT validation dependency libraries. For #6900 and #6327. svn changeset:18620/svn branch:6.6 --- WebContent/release-notes.html | 77 ++++++++++++++++++++++++++++------- 1 file changed, 62 insertions(+), 15 deletions(-) diff --git a/WebContent/release-notes.html b/WebContent/release-notes.html index 7cc4d48bd8..2c0a6f9e24 100644 --- a/WebContent/release-notes.html +++ b/WebContent/release-notes.html @@ -8,7 +8,12 @@ - + +

@@ -23,7 +28,7 @@

Version @version@ built on @builddate@.

Release Notes for Vaadin @version@

Release Notes for Vaadin Framework @version@

Overview

GWT has been updated to version 2.3

If using Eclipse, update the Vaadin Plugin for Eclipse to the latest version before upgrading a project to use the new Vaadin version
If using build scripts to compile widget sets, after upgrading GWT libraries, copy and add also the validation-api-1.0.0.GA.jar and validation-api-1.0.0.GA-sources.jar to the class path
See the General Upgrade Notes for more information

An error is shown to the end user when JAR and widgetset version do not match (#5423)
Support for touch device interfaces: one-finger touch scrolling, drag and drop, Slider, SplitPanel, sub-window handling, notifications, etc.
Support for Internet Explorer 9

General Upgrade Notes

When upgrading from an earlier version of the Vaadin library, you should always do the following:

When upgrading from an earlier version of the Vaadin library, you should always do the following.

Eclipse Users

Install the new Vaadin JAR to your project
Upgrade the Vaadin Integration Plugin for Eclipse to the latest version

If using the Vaadin Plugin in Eclipse, download and select the new version in project preferences.
For using pre-release versions of Vaadin and nightly builds, it is either recommended or often necessary to use the unstable "experimental" Vaadin Plugin for Eclipse. +If that is the case, add http://vaadin.com/eclipse/experimental as a Software Site in Eclipse and upgrade the Vaadin Plugin.

Install new GWT JARs if the GWT version has changed

The Eclipse plugin will automatically download the new GWT and update launch configurations and the project build path when you update the Vaadin version.

If you have custom widget sets, recompile them with the new Vaadin library using the included GWT compiler
If using the Eclipse IDE: -
1. Refresh the Eclipse project by selecting the project folder and pressing F5
2. Restart the application server
3. Set your project to use the new Vaadin version
4. If you have custom widget sets, recompile them by selecting the project or the widget set and clicking the Compile Vaadin widgets button in Eclipse toolbar
5. Stop the development server, clean up the working directories, and restart the server.
+ +
¹ The Vaadin section is enabled only if the Vaadin Facet is configured for the project
+ +
NetBeans and Build Script Users
+ +
If you build the Vaadin application or the widget sets using an Ant script, such as in NetBeans, follow the following instructions:
+ +
1. Copy the vaadin-@version@.jar library to the WEB-INF/lib directory in the project and remove the old version
2. Refresh the project (in NetBeans or Eclipse)
3. If using any add-ons containing custom widget sets:
-
Using the Vaadin project facet in the Eclipse IDE does the steps 1 and 2 automatically.
+
You can use the WebContent/docs/example-source/build-widgetset.xml Ant script in the Vaadin + installation package as a template for a script for compiling the widget sets.
+ +
Maven Users
+ +
- If the Vaadin version is defined as LATEST in the pom.xml, the new version is automatically used and you simply need to recompile the project.
- If the Vaadin version is defined explicitly in the pom.xml, edit the file to change the version.
+ +
Maven downloads the defined Vaadin version and required GWT libraries automatically.
+ +
Notice that there can sometimes be a delay between the official release + of Vaadin to when it is submitted to the central repository. Once in the central repository, the + replication to other repositories can take several hours.

Notes and Limitations for Google App Engine
-- 2.39.5

Release Notes for Vaadin @version@

Release Notes for Vaadin Framework @version@

General Upgrade Notes

Eclipse Users

NetBeans and Build Script Users

Maven Users

Notes and Limitations for Google App Engine