Javadocced the fact that root preserving should not be toggled on-the-fly when the...

diff --git a/src/com/vaadin/Application.java b/src/com/vaadin/Application.java
index 83084f42132381cf9fbea2c1746f500517a85cd7..8e88a677f6c66e8cffdbf4a426a2e1de94845bb4 100644 (file)
--- a/src/com/vaadin/Application.java
+++ b/src/com/vaadin/Application.java
@@ -2319,6 +2319,10 @@ public class Application implements Terminal.ErrorListener, Serializable {
      * detect that the application is opened in a browser window where it has
      * previously been open. The framework attempts to discover this by checking
      * the value of window.name in the browser.
+     * <p>
+     * NOTE that you should avoid turning this feature on/off on-the-fly when
+     * the UI is already shown, as it might not be retained as intended.
+     * </p>
      * 
      * @param rootPreserved
      *            <code>true</code>if the same Root instance should be reused