From 684cd23ae31fafb9eda2a0cd15edb4e96de92259 Mon Sep 17 00:00:00 2001 From: Simon Ser Date: Tue, 7 Apr 2020 17:28:54 +0200 Subject: xdg-shell: explain how clients need to perform an initial commit This wasn't explicit reading the mapping requirements. Signed-off-by: Simon Ser --- stable/xdg-shell/xdg-shell.xml | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/stable/xdg-shell/xdg-shell.xml b/stable/xdg-shell/xdg-shell.xml index b77eee1..f7377a7 100644 --- a/stable/xdg-shell/xdg-shell.xml +++ b/stable/xdg-shell/xdg-shell.xml @@ -426,6 +426,11 @@ manipulate a buffer prior to the first xdg_surface.configure call must also be treated as errors. + After creating a role-specific object and setting it up, the client must + perform an initial commit without any buffer attached. The compositor + will reply with an xdg_surface.configure event. The client must + acknowledge it and is then allowed to attach a buffer to map the surface. + Mapping an xdg_surface-based role surface is defined as making it possible for the surface to be shown by the compositor. Note that a mapped surface is not guaranteed to be visible once it is mapped. -- cgit v1.2.3