From 99c214049422391d1bfbbbc69fe34e2bac145df1 Mon Sep 17 00:00:00 2001
From: Robert Ancell <robert.ancell@gmail.com>
Date: Sun, 1 Jun 2025 22:03:15 +1200
Subject: [PATCH] xdg-shell: Update documentation on array formats.

Clarify that arrays are 32-bit unsigned values and the values are defined in enums.

Signed-off-by: Robert Ancell <robert.ancell@gmail.com>
---
 stable/xdg-shell/xdg-shell.xml | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/stable/xdg-shell/xdg-shell.xml b/stable/xdg-shell/xdg-shell.xml
index c4d4685..d961252 100644
--- a/stable/xdg-shell/xdg-shell.xml
+++ b/stable/xdg-shell/xdg-shell.xml
@@ -1158,12 +1158,15 @@
 	arguments should be interpreted, and possibly how it should be
 	drawn.
 
+	The states are sent as an array of 32-bit unsigned integers in
+	native endianness. State values are defined in the state enum.
+
 	Clients must send an ack_configure in response to this event. See
 	xdg_surface.configure and xdg_surface.ack_configure for details.
       </description>
       <arg name="width" type="int"/>
       <arg name="height" type="int"/>
-      <arg name="states" type="array"/>
+      <arg name="states" type="array" summary="array of 32-bit states"/>
     </event>
 
     <event name="close">
@@ -1233,7 +1236,7 @@
 	xdg_surface.configure for details.
 
 	The capabilities are sent as an array of 32-bit unsigned integers in
-	native endianness.
+	native endianness. Capability values are defined in the wm_capabilities enum.
       </description>
       <arg name="capabilities" type="array" summary="array of 32-bit capabilities"/>
     </event>