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>