From 7d1ad1122b7a09cdc2a79f26655c2159e28539bc Mon Sep 17 00:00:00 2001 From: =?utf8?q?Jonas=20=C3=85dahl?= Date: Thu, 2 Apr 2015 15:25:53 +0800 Subject: [PATCH] xdg-shell: Some xdg_popup clarifications MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit Signed-off-by: Jonas Ådahl Reviewed-by: Bryce Harrington Reviewed-by: Pekka Paalanen --- protocol/xdg-shell.xml | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) 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. -- 2.7.4