From: Matti Tahvonen Date: Fri, 28 Nov 2008 12:28:35 +0000 (+0000) Subject: copied collaborated release notes from wiki X-Git-Tag: 6.7.0.beta1~3694 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=d03623351ab66823346a6495acc17ed04a396ef9;p=vaadin-framework.git copied collaborated release notes from wiki svn changeset:6038/svn branch:trunk --- diff --git a/WebContent/release-notes.html b/WebContent/release-notes.html index 2897239d12..281dd46506 100644 --- a/WebContent/release-notes.html +++ b/WebContent/release-notes.html @@ -29,17 +29,111 @@

Version of IT Mill Toolkit Release 5 is still in beta phase, meaning that the library should be considered unstable and is recommended for - evaluation and early adoption. Also, any - changes are possible, including API changes, before the stable release. + evaluation and early adoption. Also, any changes are possible, including API changes, + before the stable release.

- -

Important Changes

+

Client side is compiled with GWT 1.5

+

+GWT is upgraded to 1.5. In case you have built your own client side components, you need to upgrade your GWT library. Lot's of things have changed in GWT 1.5, but upgrading to is rather straightforward and as a bonus you'll get nice features from Java 1.5. See more details from GWT web site +

+

Java 5 is required

+

+Since GWT now needs java 5, support for java 1.4 is now dropped. +

+

Layout changes

+

Use debug mode during development / debugging

+

+Layouts are now more strict than before. Some components may even be invisible when using relative sizes in wrong way. During debugging/development always add the following parameter to your web.xml file: +

+
  <context-param>
+  	<param-name>Debug</param-name>
+  	<param-value>true</param-value>
+  	<description>IT Mill Toolkit debug mode</description>
+  </context-param>
+

+This will make Toolkit run some sanity checks for relatively sized components. Informative error messages are printed to server console, invalid components are painted without their relative size and colored red. +

+

+Since 5.3 this parameter is also needed to show the client side logging window ( enabled by adding the request parameter "?debug=true" to uri). +

+

Handling of relative sizes have changed, ExpandLayout? deprecated

+

+See wiki:DevDocs/RFC/RelativeSizes for details +

+

Some components now have default sizes

+

+Previously almost all components had undefined size by default. Now some containers have 100% width by default. These are: +

+

Custom tailored client side components

+

+Due to the layout changes, all child component size changes (outside updateFromUIDL function) must be announced. Most commonly this kind of change happens when an image gets loaded inside a component. There is a helper method in the Util class for doing the announcement: +

+
            Set<Widget> w = new HashSet<Widget>();
+            w.add(this);
+            Util.componentSizeUpdated(w);
+

Themes

+

+Many component have changed quite a lot due to layout refactoring. DOM structures have been changed etc. This may break old themes. +

+

+Theme building for Toolkit is not the most straightforward process as there is quite a lot of javascript magic done e.g. dimension measuring etc. If using unsupported CSS a component might be rendered in an unexpected way. "Theme builders handbook" is at the top of our TODO list. In the mean time it is often safest to override values defined in the default theme. +

+

+Especially if you encounter problems with margins or spacings, check the manual. Some CSS class names and conventions have changed. +

+

+If you have or get "broken" component on your screen, the first thing to do is to comment out all custom theme. If it works you may have the rework your css for that particular component. Things to check: +

+

+Often the easiest path for your custom theme is to override values from the default theme. +

+

Browser support changes since 5.2.x

+

+Safari 2 and Firefox 1.5 and Operas prior to version 9.6 are no longer supported. Users of these browsers are strongly encouraged to move to newer versions. +

+

+Google Chrome is not yet supported, but it is known to work rather well as it is a close relative to Safari. +

+

+GWT Hosted mode on Linux uses same Gecko version as FF 1.5 and is currently partly broken. Some layout's don't render properly. We hope to resolve these issues soon with next generation Hosted Mode Browser aka OOPHM or with minor hacks to the client side code. +

+

Minor Changes

+

+Version 5.3 contains lots of small changes also (more than 200), which might not be worth mentioning in the release notes, but here are some of them. +

+

+- New sub-window theme
+- Tabsheet HTML-structure has changed
+- Better shadow support for overlay elements
+- Row and column icons for Table
+- New component: PopupPanel/PopupView
+- Theme changing on-the-fly
+- Table cellstyle and rowstyle generators
+- New component: MenuBar (is this in the release?)
+- Security: double-cookie submission pattern
+- Low level bookmarking and history support
+- Sub-windows can be centered on screen. Modal windows are centered automatically
+- Link component now behaves like a normal "weblink"
+

+ + + + + ======

The release if IT Mill Toolkit includes new features and a number of fixed problems compared to the older 5.2.x version. Major changes and dozens of bug - fixes have been done.

+ fixes have been done. Only major issues handled below.

-

TODO include 5.3 changes from wiki

For up-to-date status of known problems, see the developer website dev.itmill.com.