From: Matti Tahvonen <matti.tahvonen@itmill.com>
Date: Fri, 21 Dec 2007 08:47:19 +0000 (+0000)
Subject: Fixing documentation for javascript layout functions.
X-Git-Tag: 6.7.0.beta1~5201
X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=0aef3534bff370b5803c610bda3e5e97dbd42451;p=vaadin-framework.git

Fixing documentation for javascript layout functions.

svn changeset:3290/svn branch:trunk
---

diff --git a/src/com/itmill/toolkit/terminal/gwt/client/ui/ICustomLayout.java b/src/com/itmill/toolkit/terminal/gwt/client/ui/ICustomLayout.java
index b96c99dfad..b16fa8b660 100644
--- a/src/com/itmill/toolkit/terminal/gwt/client/ui/ICustomLayout.java
+++ b/src/com/itmill/toolkit/terminal/gwt/client/ui/ICustomLayout.java
@@ -427,11 +427,17 @@ public class ICustomLayout extends ComplexPanel implements Paintable,
     /**
      * In custom layout one may want to run layout functions made with
      * JavaScript. This function tests if one exists (with name "iLayoutJS" in
-     * layouts first DOM node) and runs if it. Return value is used to determine
-     * is children needs to be notified of size changes.
+     * layouts first DOM node) and runs et. Return value is used to determine if
+     * children needs to be notified of size changes.
+     * 
+     * Note! When implementing a JS layout function you most likely want to call
+     * notifyChildrenOfSizeChange() function on your custom layouts main
+     * element. That method is used to control whether child components layout
+     * functions are to be run.
      * 
      * @param el
-     * @return true if layout function was run and it returned true.
+     * @return true if layout function exists and was run successfully, else
+     *         false.
      */
     private native boolean iLayoutJS(Element el)
     /*-{