Improved deprecation message based on review (#9522)

diff --git a/server/src/com/vaadin/server/Page.java b/server/src/com/vaadin/server/Page.java
index 1b22c93d78115523875b2a7469ff8b9d0aa983a0..ccc400341eadd3eb69ab659ba5cb05de6bcaa336 100644 (file)
--- a/server/src/com/vaadin/server/Page.java
+++ b/server/src/com/vaadin/server/Page.java
@@ -32,6 +32,7 @@ import com.vaadin.ui.JavaScript;
 import com.vaadin.ui.Link;
 import com.vaadin.ui.Notification;
 import com.vaadin.ui.UI;
+import com.vaadin.ui.UI.LegacyWindow;
 import com.vaadin.util.ReflectTools;
 
 public class Page implements Serializable {
@@ -664,7 +665,9 @@ public class Page implements Serializable {
 
     /**
      * @deprecated only retained to maintain compatibility with
-     *             LegacyWindow.open methods
+     *             LegacyWindow.open methods. See documentation for
+     *             {@link LegacyWindow#open(Resource, String, int, int, BorderStyle)}
+     *             for discussion about replacing API.
      */
     @Deprecated
     public void open(Resource resource, String windowName, int width,