Merged VPopupView showPopupView javadoc from 6.1

svn changeset:9589/svn branch:6.2

diff --git a/src/com/vaadin/terminal/gwt/client/ui/VPopupView.java b/src/com/vaadin/terminal/gwt/client/ui/VPopupView.java
index 36706bdede88e3d3ec7e1899b63221622768457b..630302eeaf57c30e0428d37a0b07a372f379bba0 100644 (file)
--- a/src/com/vaadin/terminal/gwt/client/ui/VPopupView.java
+++ b/src/com/vaadin/terminal/gwt/client/ui/VPopupView.java
@@ -150,6 +150,17 @@ public class VPopupView extends HTML implements Container, Iterable<Widget> {
         popup.show();
     }
 
+    /**
+     * Determines the correct position for a popup and displays the popup at
+     * that position.
+     * 
+     * By default, the popup is shown centered relative to its host component,
+     * ensuring it is visible on the screen if possible.
+     *
+     * Can be overridden to customize the popup position.
+     *
+     * @param popup
+     */
     protected void showPopup(final CustomPopup popup) {
         int windowTop = RootPanel.get().getAbsoluteTop();
         int windowLeft = RootPanel.get().getAbsoluteLeft();