From 2f6310efadab44dedaf7801a9b6274d5c26acfa3 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Marko=20Gr=C3=B6nroos?= Date: Tue, 19 May 2009 08:11:38 +0000 Subject: [PATCH] Updated Release Notes for Vaadin 6.0.0 release. svn changeset:7872/svn branch:6.0 --- WebContent/release-notes.html | 96 +++++++++++++++++++++-------------- 1 file changed, 58 insertions(+), 38 deletions(-) diff --git a/WebContent/release-notes.html b/WebContent/release-notes.html index 766094f43b..a7855029af 100644 --- a/WebContent/release-notes.html +++ b/WebContent/release-notes.html @@ -25,28 +25,34 @@ community and support site vaadin.com
-

Release Notes for Vaadin Version @version@

+

Release Notes for Vaadin @version@

-

Vaadin 6.0.0 is the first release of Vaadin, the next generation of the framework +

Vaadin @version@ 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:

+IT Mill Toolkit 5.4, along with many bug fixes. The most significant additions are:

  • Vaadin Plugin for the Eclipse IDE
    • -
  • WYSIWYG Editor under Eclipse
    • +
  • Preview version of a 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.
    • -
  • +
  • State (caption, hidden, disabled) of a tab in a TabSheet is no longer bound to the contained component, though the initial state is obtained from the component (#2914).
    • + +
  • 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
    • + +
  • Panel and Window can now contain a ComponentContainer as the "root layout" (previously only Layout) (#2921). This should not require changes to user code.
+

The first three changes are not backward-compatible with IT Mill Toolkit 5.4.

+

Instructions for Upgrading from IT Mill Toolkit 5

-

While the Vaadin 6 API is otherwise backward-compatible with IT Mill Toolkit 5.4, the +

While the Vaadin 6 API is otherwise mostly 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.

@@ -55,40 +61,41 @@ some name prefixes, and some other details.

  • 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
      • +
    • In all Java files using IT Mill Toolkit, rename package prefix com.itmill.toolkit → com.vaadin
      • +
    • You also need to update the web.xml deployment descriptor:
      • +
        +
      • The servlet class is now com.vaadin.terminal.gwt.server.ApplicationServlet.
        • +
  • Changes in themes:
      -
    • WebContent/ITMILL has been renamed to WebContent/VAADIN
      • +
    • Rename WebContent/ITMILL → WebContent/VAADIN
        • +
      • If you have extracted the built-in themes and widgetsets in IT Mill Toolkit JAR to the folder to have them served statically by the server, remove the old content and re-extract from Vaadin JAR.
      • 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"
      • +
    • The new "reindeer" theme is the default theme in Vaadin; the old + "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");
        • +
      • In your custom theme, replace: + + + +
      • Use the new default theme with setTheme("reindeer") and the old one 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
          • +
        • Search and replace ".i-" → ".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"
          • +
        • The name of the JavaScript variable used for launching applications has changed from "itmill.toolkitConfigurations" → "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

        @@ -98,12 +105,17 @@ 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 +
            +
          • You need to upgrade GWT
            • +
          • The GWT Compiler class name has changed:
            • +
              +
            • Replace com.google.gwt.dev.GWTCompiler → com.google.gwt.dev.Compiler in your widget set build script (Ant) or launch configuration (Eclipse).
              • +
            +
          • Possible problems when building widgetset using Windows and JDK 1.5. See Known Problems #2891 below.
            • +
          -
        • 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 +
        • The "I" (IT Mill) prefix in client-side widget classes has been changed to "V" (Vaadin), for example: IButton → VButton.
          • +
        • Rename IToolkitOverlay → VOverlay

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

        @@ -130,7 +142,7 @@ debugging purposes during development. For production use, you should compile your custom widget sets with the regular Vaadin package for your platform.

        -

        Important known problems in @version@

        +

        Important known problems in Vaadin @version@

        • #1155 @@ -146,6 +158,20 @@ for your platform.

          GWT code. You need to install the experimental OOPHM package instead (see above) for development. For production, you should use the regular package for Linux.
          • + +
        • +

          #2891 As there is a bug in J2SE + 5.0 that prevents setting the stack size for the main thread, widgetsets cannot be + compiled using the standard GWT compiler of GWT 1.6 and JDK 1.5.0 (see #2656 for + more details on the JDK bug). This bug primarily affects Windows users as other + operating systems have a larger default stack size.

          + +

          Before that fix is available in a published GWT version, we provide a wrapper for + the GWT compiler that runs the compiler in a separate thread, thus using the + user-specified stack size settings also on JDK 1.5.0. Use + com.itmill.toolkit.launcher.WidgetsetCompiler instead of + com.google.gwt.dev.Compiler

          +

        For other known problems, see open tickets at developer site

        -

        † Internet Explorer 8 RC1 may not be usable because of a -serious bug in the RC1. #2578
        - -‡ The current support for Opera has some limitations, such as the front page of -the Sampler demo. #2652

        -

        The support for browsers follows the support by GWT. The browsers are supported on both Windows and Mac, if available. Firefox is supported also on Linux (Opera 10a1 works also on Linux though also suffers from

        @import "../default/styles.css";
        →@import "../reindeer/styles.css";if you wish to use the new default theme,
        or →@import "../runo/styles.css";if you wish to use the old default theme.