From 1f9029ae49242f8050e47f94b56491000d997566 Mon Sep 17 00:00:00 2001
From: Julian Orth <ju.orth@gmail.com>
Date: Sat, 26 Jul 2025 20:08:38 +0200
Subject: [PATCH] linux-dmabuf: deprecate all flags

I've looked at the behaviors of some compositors:

- Mutter & Weston fail buffer creation if any flag other than y_invert
  is used.
- Sway and KWin fail buffer creation if any flag is used.
- Jay ignores all flags.

Since clients are clearly not using these flags on general-purpose
compositors and there is no way for clients to detect which flags are
supported or why buffer creation failed, deprecate all flags.

Signed-off-by: Julian Orth <ju.orth@gmail.com>
---
 stable/linux-dmabuf/linux-dmabuf-v1.xml | 29 ++++++++++++++++++++-----
 1 file changed, 23 insertions(+), 6 deletions(-)

diff --git a/stable/linux-dmabuf/linux-dmabuf-v1.xml b/stable/linux-dmabuf/linux-dmabuf-v1.xml
index 12d09fb..ad250a3 100644
--- a/stable/linux-dmabuf/linux-dmabuf-v1.xml
+++ b/stable/linux-dmabuf/linux-dmabuf-v1.xml
@@ -24,7 +24,7 @@
     DEALINGS IN THE SOFTWARE.
   </copyright>
 
-  <interface name="zwp_linux_dmabuf_v1" version="5">
+  <interface name="zwp_linux_dmabuf_v1" version="6">
     <description summary="factory for creating dmabuf-based wl_buffers">
       This interface offers ways to create generic dmabuf-based wl_buffers.
 
@@ -184,7 +184,7 @@
     </request>
   </interface>
 
-  <interface name="zwp_linux_buffer_params_v1" version="5">
+  <interface name="zwp_linux_buffer_params_v1" version="6">
     <description summary="parameters for creating a dmabuf-based wl_buffer">
       This temporary object is a collection of dmabufs and other
       parameters that together form a single logical buffer. The temporary
@@ -222,6 +222,8 @@
       <entry name="invalid_wl_buffer" value="7"
              summary="invalid wl_buffer resulted from importing dmabufs via
                the create_immed request on given buffer_params"/>
+      <entry name="deprecated_flag" value="8"
+	     summary="a deprecated flag was used"/>
     </enum>
 
     <request name="destroy" type="destructor">
@@ -264,9 +266,24 @@
     </request>
 
     <enum name="flags" bitfield="true">
-      <entry name="y_invert" value="1" summary="contents are y-inverted"/>
-      <entry name="interlaced" value="2" summary="content is interlaced"/>
-      <entry name="bottom_first" value="4" summary="bottom field first"/>
+      <entry name="y_invert" value="1" deprecated-since="6">
+	<description summary="contents are y-inverted">
+	  This flag is deprecated since version 6. Trying to use it causes the
+	  deprecated_flag error.
+	</description>
+      </entry>
+      <entry name="interlaced" value="2" deprecated-since="6">
+	<description summary="content is interlaced">
+	  This flag is deprecated since version 6. Trying to use it causes the
+	  deprecated_flag error.
+	</description>
+      </entry>
+      <entry name="bottom_first" value="4" deprecated-since="6">
+	<description summary="bottom field first">
+	  This flag is deprecated since version 6. Trying to use it causes the
+	  deprecated_flag error.
+	</description>
+      </entry>
     </enum>
 
     <request name="create">
@@ -396,7 +413,7 @@
     </request>
   </interface>
 
-  <interface name="zwp_linux_dmabuf_feedback_v1" version="5">
+  <interface name="zwp_linux_dmabuf_feedback_v1" version="6">
     <description summary="dmabuf feedback">
       This object advertises dmabuf parameters feedback. This includes the
       preferred devices and the supported formats/modifiers.