From a3cf97ff982638bf7ed23b4303eba280c521b54d Mon Sep 17 00:00:00 2001 From: Jonas Ådahl Date: Wed, 10 May 2017 13:50:10 +0800 Subject: xdg-shell/popup: Allow custom parent by passing null as parent MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Allow using some other protocol (custom, or future xdg_* based) to set up the parent-child relationship of a popup. This allows future protocols to use xdg_popup when mapping popups over surfaces not based on xdg_surface. An example use case for this is the window menu, where a shells UI client can use xdg_popup to create popup menus over windows it does not have a xdg_surface of by having a custom protocol setting up the proper parent-child relationship. Signed-off-by: Jonas Ådahl Reviewed-By: Mike Blumenkrantz --- stable/xdg-shell/xdg-shell.xml | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) (limited to 'stable/xdg-shell') diff --git a/stable/xdg-shell/xdg-shell.xml b/stable/xdg-shell/xdg-shell.xml index 4c4c66b..77ce886 100644 --- a/stable/xdg-shell/xdg-shell.xml +++ b/stable/xdg-shell/xdg-shell.xml @@ -424,14 +424,17 @@ - This creates an xdg_popup object for the given xdg_surface and gives the - associated wl_surface the xdg_popup role. + This creates an xdg_popup object for the given xdg_surface and gives + the associated wl_surface the xdg_popup role. + + If null is passed as a parent, a parent surface must be specified using + some other protocol, before committing the initial state. See the documentation of xdg_popup for more details about what an xdg_popup is and how it is used. - + -- cgit v1.2.3