From 00d93cfaaa0a740ec4d0984fe6cdecf9fdb80f54 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Marko=20Gr=C3=B6nroos?= Date: Mon, 18 May 2009 19:54:43 +0000 Subject: [PATCH] Release Notes for Vaadin 6.0 updated. svn changeset:7868/svn branch:6.0 --- WebContent/release-notes.html | 117 +++++++++++++++++++++++++++------- 1 file changed, 94 insertions(+), 23 deletions(-) diff --git a/WebContent/release-notes.html b/WebContent/release-notes.html index d7238c07e5..766094f43b 100644 --- a/WebContent/release-notes.html +++ b/WebContent/release-notes.html @@ -2,7 +2,7 @@ -IT Mill Toolkit 5 +Vaadin 6
-

Release Notes for IT Mill Toolkit Version @version@

+

Release Notes for Vaadin Version @version@

-

Version 5.3.0 is the first stable release of IT Mill Toolkit 5, -meaning that there are no known major problems and the API will be kept -backward compatible.

+

Vaadin 6.0.0 is the first release of Vaadin, the next generation of the framework +formerly known as IT Mill Toolkit. The major release includes a number of enhancements to +IT Mill Toolkit 5.4.0, along with many bug fixes. The most notable additions are:

+ +
    +
  • Vaadin Plugin for the Eclipse IDE
    • +
  • WYSIWYG Editor under Eclipse
    • +
+ +

Some other notable changes:

+ +
    +
  • TabSheet API has changed (#2914)
    • +
  • Panel and Window can now contain a ComponentContainer as the "root layout" (previously only Layout) (#2921). This should not require changes to user code.
    • +
  • +
+ +

Instructions for Upgrading from IT Mill Toolkit 5

+ +

While the Vaadin 6 API is otherwise backward-compatible with IT Mill Toolkit 5.4, the +change of the product name has made it necessary to reflect it in the Java package names, +some name prefixes, and some other details.

+ +

Server-side Upgrade Instructions

+ +
    +
  • Java Package names have changed:
    • +
      +
    • Renamed com.itmill.toolkit to com.vaadin
      • +
    • Applies to all Java files using IT Mill Toolkit
      • +
    • The web.xml deployment descriptor must also be updated
      • +
    + +
  • Changes in themes: +
      +
    • WebContent/ITMILL has been renamed to WebContent/VAADIN
      • +
        +
      • This may require changes to build scripts for custom widgetsets, as well as to any code that relies on the old naming (it is discouraged but possible).
        • +
      +
    • The new "reindeer" theme is the default theme in Vaadin.
      • +
    • The "default" theme in IT Mill Toolkit 5 has been renamed as "runo"
      • +
        +
      • Custom themes that import the "default" theme should instead import "runo".
        • +
      • There is no longer a theme with name "default"
        • +
      • The old default theme can be used with setTheme("runo");
        • +
      +
    • CSS class names now start with "v-" prefix instead of "i-"
      • +
        +
      • To fix: search ".i-" and replace with ".v-" in custom themes
        • +
      +
    + +
  • Embedding Vaadin applications in web pages:
    • +
      +
    • The name of the JavaScript variable used for launching applications has changed from "itmill.toolkitConfigurations" to "vaadin.vaadinConfigurations"
      • +
    + +
  • Other API changes:
    • +
      +
    • FieldFactory has been split into FormFieldFactory and TableFieldFactory, both containing a single method (#2956, #2499).
      • +
    • The Form component previously called two methods in FieldFactory. Now it always calls only one in FormFieldFactory
      • +
    +
+ +

Client-side Upgrade Instructions

+ +

The following changes are relevant only if you have developed or integrated custom +client-side widgets with Google Web Toolkit (GWT).

+ +
    +
  • GWT 1.6 is required for compiling custom widgets (optional)
    • + o Possible problems when building widgetset using Windows and JDK 1.5 (#2891) + o GWT version in the projects must be updated (done automatically by the plugin) + o GWT Compiler class name has changed + +
  • The "I" (IT Mill) prefix in client-side widget classes has been changed to "V" (Vaadin), for example: IButton is now VButton.
    • +
  • IToolkitOverlay is now VOverlay +

Package for the experimental GWT Out-of-Process Hosted Mode

@@ -41,10 +116,9 @@ browser. Using the OOPHM requires installing a browser plugin (available for Mozilla Firefox, IE, and WebKit). See the manual section on OOPHM for more details.

-

The Linux version of GWT Hosted Mode Browser is no longer -compatible with IT Mill Toolkit 5.3.0 (#2299), so the OOPHM is -the only option for debugging in hosted mode in Linux.

+

The Linux version of GWT Hosted Mode Browser is no longer compatible with Vaadin (#2299), so the OOPHM is the only option for +debugging in hosted mode in Linux.

The compilation of OOPHM widget sets uses a large amount of stack memory, so if the JVM default is too small, you should set it explicitly in compile-widgetset.xml @@ -53,7 +127,7 @@ script): <jvmarg value="-Xss1024k"/>.

As the OOPHM package is experimental, you should use it only for debugging purposes during development. For production use, you should -compile your custom widget sets with the regular IT Mill Toolkit package +compile your custom widget sets with the regular Vaadin package for your platform.

Important known problems in @version@

@@ -79,7 +153,7 @@ for your platform.

Requirements

-

IT Mill Toolkit is available for the following operating systems:

+

Vaadin is available for the following operating systems:

  • Windows (see the Zip installation notice above)
    • @@ -92,7 +166,7 @@ for your platform.

    for Linux.
-

IT Mill Toolkit supports Java Servlet API 2.3 and later versions and should work with +

Vaadin supports Java Servlet API 2.3 and later versions and should work with any Java application server that conforms to the standard. It supports the following application servers:

@@ -105,7 +179,7 @@ application servers:

  • Glassfish, version 2 or later
    • -

    IT Mill Toolkit supports the following browsers for using the applications made with +

    Vaadin supports the following browsers for using the applications made with it:

      @@ -126,7 +200,7 @@ Windows and Mac, if available. Firefox is supported also on Linux (Opera 10a1 wo on Linux though also suffers from #2652). There may be differences between the exact versions of the supported browsers that may cause incompatibility with applications -made with IT Mill Toolkit.

      +made with Vaadin.

      The following browsers are not supported but have been found to work to a large degree:

      @@ -146,12 +220,9 @@ work to a large degree:

      as well.

      Nokia E-series phones, such as E90, have been known to work with older versions, but -not with IT Mill Toolkit 5.2 and later. Links, Lynx, and other text-based browsers do not +not with Vaadin 6. Links, Lynx, and other text-based browsers do not work.

      -
    - -
    -- 2.39.5