From: Jonas Ådahl Date: Thu, 2 Apr 2015 07:25:53 +0000 (+0800) Subject: xdg-shell: Some xdg_popup clarifications X-Git-Tag: 1.7.91~4 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=7d1ad1122b7a09cdc2a79f26655c2159e28539bc;p=platform%2Fupstream%2Fweston.git xdg-shell: Some xdg_popup clarifications Signed-off-by: Jonas Ådahl Reviewed-by: Bryce Harrington Reviewed-by: Pekka Paalanen --- diff --git a/protocol/xdg-shell.xml b/protocol/xdg-shell.xml index 9651f10..50ffd9c 100644 --- a/protocol/xdg-shell.xml +++ b/protocol/xdg-shell.xml @@ -469,11 +469,14 @@ A parent surface must be mapped before the new popup is mapped. When compositors choose to dismiss a popup, they will likely - dismiss every nested popup as well. - - The x and y arguments specify where the top left of the popup - should be placed, relative to the local surface coordinates of the - parent surface. + dismiss every nested popup as well. When a compositor dismisses + popups, it will follow the same dismissing order as required + from the client. + + The x and y arguments passed when creating the popup object specify + where the top left of the popup should be placed, relative to the + local surface coordinates of the parent surface. See + xdg_shell.get_xdg_popup. The client must call wl_surface.commit on the corresponding wl_surface for the xdg_popup state to take effect.