improving windowing javadocs

svn changeset:6485/svn branch:trunk

diff --git a/src/com/itmill/toolkit/Application.java b/src/com/itmill/toolkit/Application.java
index a1ce33531c97477334c4cd73faab984ff702ab54..fa4f5e9a9d4c68119a6a650d25b5088b97bbad68 100644 (file)
--- a/src/com/itmill/toolkit/Application.java
+++ b/src/com/itmill/toolkit/Application.java
@@ -211,18 +211,27 @@ public abstract class Application implements URIHandler, Terminal.ErrorListener
      * method can be left as is. In case browser-level windows are needed, it is
      * recommended to create new window-objects on this method from their names
      * if the super.getWindow() does not find existing windows. See below for
-     * implementation example:
-     * <code>  // If we already have the requested window, use it
+     * implementation example: <code><pre>
+        // If we already have the requested window, use it
         Window w = super.getWindow(name);
         if (w == null) {
-
             // If no window found, create it
-            w = createNewWindow(name);
-        }
-        return w;</code>
+            w = new Window(name);
+            // set windows name to the one requested
+            w.setName(name);
+            // add it to this application
+            addWindow(w);
+            // add some content
+            w.addComponent(new Label("Test window"));
+        }
+        return w;</pre></code>
      * </p>
      * 
      * <p>
+     * <strong>Note</strong> that all returned Window objects must be added to
+     * this application instance.
+     * 
+     * <p>
      * The method should return null if the window does not exists (and is not
      * created as a side-effect) or if the application is not running anymore.
      * </p>