From f9bcfa6c70d167c5423f1f66647c7ec798d3d3b0 Mon Sep 17 00:00:00 2001
From: "Anna (navi) Figueiredo Gomes" <navi@vlhl.dev>
Date: Sat, 20 Jan 2024 16:52:29 +0100
Subject: ext-action-binder: error when attempting to set a property twice

Signed-off-by: Anna (navi) Figueiredo Gomes <navi@vlhl.dev>
---
 staging/ext-action-binder/ext-action-binder-v1.xml | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/staging/ext-action-binder/ext-action-binder-v1.xml b/staging/ext-action-binder/ext-action-binder-v1.xml
index bca7bf7..7c1d056 100644
--- a/staging/ext-action-binder/ext-action-binder-v1.xml
+++ b/staging/ext-action-binder/ext-action-binder-v1.xml
@@ -86,6 +86,8 @@
       <description summary="sets the namespace:name of a binding">
         This an action.
         Sets the namespace:name of the binding.
+
+        Attempting to send this request twice or after the binding was bound raises an already set error
       </description>
       <arg name="namespace" type="string" summary="the action namespace" />
       <arg name="name" type="string" summary="the action name" />
@@ -95,6 +97,8 @@
       <description summary="sets the human-readable description of a binding">
         This setting is optional.
         This description may be used by the compositor to render a ui for bindings.
+
+        Attempting to send this request twice or after the binding was bound raises an already_set error
       </description>
       <arg name="description" type="string" summary="a human-readable description of what the binding does" />
     </request>
@@ -102,6 +106,8 @@
     <request name="set_app_id">
       <description summary="sets an app_id for this binding">
         This setting is optional.
+
+        Attempting to send this request twice or after the binding was bound raises an already_set error
       </description>
       <arg name="app_id" type="string" summary="app_id of the application requesting this bind"/>
     </request>
@@ -109,6 +115,8 @@
     <request name="set_seat">
       <description summary="sets a target seat">
         This setting is optional.
+
+        Attempting to send this request twice or after the binding was bound raises an already_set error
       </description>
       <arg name="seat" type="object" interface="wl_seat" summary="target seat"/>
     </request>
@@ -135,6 +143,8 @@
         hold: 1-5 fingers, no direction
         swipe: 3-5 fingers, up, down, left or right
         pinch: 2-5 fingers, all above, inward, outward, clockwise, counterclockwise
+
+        Attempting to send this request twice or after the binding was bound raises an already_set error
       </description>
       <arg name="kind" type="string" summary="what category of trigger it fits in"/>
       <arg name="trigger" type="string" summary="a trigger that the client would like to trigger the action"/>
@@ -186,5 +196,8 @@
       <arg name="time" type="uint" summary="timestamp with millisecond granularity"/>
       <arg name="type" type="uint" enum="trigger_type" summary="the type of trigger that was sent"/>
     </event>
+    <enum name="error">
+      <entry name="already_set" value="0" summary="property was already set"/>
+    </enum>
   </interface>
 </protocol>
-- 
cgit v1.2.3