Merge branch 'work/zzag/xdg-shell-configure-clarification' into 'main'

xdg-shell: Clarify xdg_surface.ack_configure behavior

See merge request wayland/wayland-protocols!374
This commit is contained in:
Vlad Zahorodnii 2026-05-13 21:02:31 +00:00
commit 3961bc9d46

View file

@ -573,10 +573,6 @@
Acking a configure event that was never sent raises an invalid_serial
error.
A client is not required to commit immediately after sending
an ack_configure request - it may even ack_configure several times
before its next surface commit.
A client may send multiple ack_configure requests before committing, but
only the last request sent before a commit indicates which configure
event the client really is responding to.
@ -611,6 +607,10 @@
an ack_configure request with the serial sent in this configure event at
some point before committing the new surface.
The client must send an ack_configure request and commit the surface
within a reasonable amount of time. The surface must be committed even if
there are no visible changes in response to the configure event.
If the client receives multiple configure events before it can respond
to one, it is free to discard all but the last event it received.
</description>