From 8f499bf4045f88f3a4b4b0a445befca467bebe20 Mon Sep 17 00:00:00 2001
From: Kirill Primak <vyivel@eclair.cafe>
Date: Fri, 19 Jan 2024 13:34:37 +0300
Subject: [PATCH] protocol: clarify pending wl_buffer destruction

This matches the current behavior of KWin, Mutter, and Weston.

References: https://gitlab.freedesktop.org/wayland/wayland/-/issues/387
Signed-off-by: Kirill Primak <vyivel@eclair.cafe>
---
 protocol/wayland.xml | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/protocol/wayland.xml b/protocol/wayland.xml
index 59bedaa4..93f9d553 100644
--- a/protocol/wayland.xml
+++ b/protocol/wayland.xml
@@ -1512,8 +1512,9 @@
 	mutates the underlying buffer storage, the surface contents become
 	undefined immediately.
 
-	If wl_surface.attach is sent with a NULL wl_buffer, the
-	following wl_surface.commit will remove the surface content.
+	If wl_surface.attach is sent with a NULL wl_buffer, or the pending
+	wl_buffer has been destroyed, the following wl_surface.commit will
+	remove the surface content.
       </description>
       <arg name="buffer" type="object" interface="wl_buffer" allow-null="true"
 	   summary="buffer of surface contents"/>