summaryrefslogtreecommitdiff
path: root/stable
diff options
context:
space:
mode:
authorSimon Ser <contact@emersion.fr>2024-08-25 14:40:23 +0200
committerSimon Ser <contact@emersion.fr>2024-09-05 19:15:01 +0000
commitb4a42c88f49d1e163e964d2aeebff391af4afa2f (patch)
tree49bdb53e923b9c32c084aac34eafcd03cd32efd3 /stable
parentdf2b5e5e7b507515a54e5f5f3b410da5dc05d690 (diff)
xdg-shell: clarify clients set their initial state before initial commit
It wasn't clear that it's important clients set up their initial xdg_surface state before they send the initial commit. This is required for the compositor to be able to send a proper configure event depending on size constraints and any policies it might want to apply (e.g. specific app ID always shows up in a designated workspace). Signed-off-by: Simon Ser <contact@emersion.fr>
Diffstat (limited to 'stable')
-rw-r--r--stable/xdg-shell/xdg-shell.xml3
1 files changed, 2 insertions, 1 deletions
diff --git a/stable/xdg-shell/xdg-shell.xml b/stable/xdg-shell/xdg-shell.xml
index bf25b66..1caf6f1 100644
--- a/stable/xdg-shell/xdg-shell.xml
+++ b/stable/xdg-shell/xdg-shell.xml
@@ -434,7 +434,8 @@
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
+ After creating a role-specific object and setting it up (e.g. by sending
+ the title, app ID, size constraints, parent, etc), the client must
perform an initial commit without any buffer attached. The compositor
will reply with initial wl_surface state such as
wl_surface.preferred_buffer_scale followed by an xdg_surface.configure