[PATCH wayland-protocols v3 08/17] xdg-shell/toplevel: Clarify xdg_toplevel.set_parent(null)

Jonas Ådahl jadahl at gmail.com
Wed Nov 15 11:19:57 UTC 2017


Setting a null-surface as a toplevel parent should unset the
parent-child relationship. This was not specified, so lets do that.

Signed-off-by: Jonas Ådahl <jadahl at gmail.com>
Signed-off-by: Mike Blumenkrantz <zmike at osg.samsung.com>
---
 stable/xdg-shell/xdg-shell.xml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/stable/xdg-shell/xdg-shell.xml b/stable/xdg-shell/xdg-shell.xml
index c7dd6dd..b119cff 100644
--- a/stable/xdg-shell/xdg-shell.xml
+++ b/stable/xdg-shell/xdg-shell.xml
@@ -547,6 +547,10 @@
 	Parent windows should be set on dialogs, toolboxes, or other
 	"auxiliary" surfaces, so that the parent is raised when the dialog
 	is raised.
+
+	Setting a null parent for a child window removes any parent-child
+	relationship for the child. Setting a null parent for a window which
+	currently has no parent is a no-op.
       </description>
       <arg name="parent" type="object" interface="xdg_toplevel" allow-null="true"/>
     </request>
-- 
2.14.2



More information about the wayland-devel mailing list