third_party: Amend version 3 of remote shell protocol

third_party/wayland-protocols/include/protocol/remote-shell-unstable-v1-client-protocol.h

 /* Generated by wayland-scanner 1.11.0 */
 
 #ifndef REMOTE_SHELL_UNSTABLE_V1_CLIENT_PROTOCOL_H
 #define REMOTE_SHELL_UNSTABLE_V1_CLIENT_PROTOCOL_H
 
 #include <stdint.h>
 #include <stddef.h>
 #include "wayland-client.h"
 
 #ifdef  __cplusplus
@@ skipping 170 matching lines @@
          */
         ZCR_REMOTE_SHELL_V1_STATE_TYPE_FULLSCREEN = 4,
         /**
          * pinned window state
          */
         ZCR_REMOTE_SHELL_V1_STATE_TYPE_PINNED = 5,
         /**
          * trusted pinned window state
          */
         ZCR_REMOTE_SHELL_V1_STATE_TYPE_TRUSTED_PINNED = 6,
+        /**
+         * moving window state
+         */
+        ZCR_REMOTE_SHELL_V1_STATE_TYPE_MOVING = 7,
 };
 #endif /* ZCR_REMOTE_SHELL_V1_STATE_TYPE_ENUM */
 
 #ifndef ZCR_REMOTE_SHELL_V1_ERROR_ENUM
 #define ZCR_REMOTE_SHELL_V1_ERROR_ENUM
 enum zcr_remote_shell_v1_error {
         /**
          * given wl_surface has another role
          */
         ZCR_REMOTE_SHELL_V1_ERROR_ROLE = 0,
@@ skipping 50 matching lines @@
                                       int32_t transform,
                                       wl_fixed_t scale_factor,
                                       int32_t work_area_inset_left,
                                       int32_t work_area_inset_top,
                                       int32_t work_area_inset_right,
                                       int32_t work_area_inset_bottom,
                                       uint32_t layout_mode);
 };
 
 /**
- * @ingroup zcr_remote_shell_v1_iface
+ * @ingroup iface_zcr_remote_shell_v1
  */
 static inline int
 zcr_remote_shell_v1_add_listener(struct zcr_remote_shell_v1 *zcr_remote_shell_v1,
                                  const struct zcr_remote_shell_v1_listener *listener, void *data)
 {
         return wl_proxy_add_listener((struct wl_proxy *) zcr_remote_shell_v1,
                                      (void (**)(void)) listener, data);
 }
 
-#define ZCR_REMOTE_SHELL_V1_DESTROY     0
-#define ZCR_REMOTE_SHELL_V1_GET_REMOTE_SURFACE  1
-#define ZCR_REMOTE_SHELL_V1_GET_NOTIFICATION_SURFACE    2
+#define ZCR_REMOTE_SHELL_V1_DESTROY 0
+#define ZCR_REMOTE_SHELL_V1_GET_REMOTE_SURFACE 1
+#define ZCR_REMOTE_SHELL_V1_GET_NOTIFICATION_SURFACE 2
 
 /**
  * @ingroup iface_zcr_remote_shell_v1
  */
-#define ZCR_REMOTE_SHELL_V1_DESTROY_SINCE_VERSION       1
+#define ZCR_REMOTE_SHELL_V1_ACTIVATED_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_shell_v1
  */
-#define ZCR_REMOTE_SHELL_V1_GET_REMOTE_SURFACE_SINCE_VERSION    1
+#define ZCR_REMOTE_SHELL_V1_CONFIGURATION_CHANGED_SINCE_VERSION 1
+
 /**
  * @ingroup iface_zcr_remote_shell_v1
  */
-#define ZCR_REMOTE_SHELL_V1_GET_NOTIFICATION_SURFACE_SINCE_VERSION      1
+#define ZCR_REMOTE_SHELL_V1_DESTROY_SINCE_VERSION 1
+/**
+ * @ingroup iface_zcr_remote_shell_v1
+ */
+#define ZCR_REMOTE_SHELL_V1_GET_REMOTE_SURFACE_SINCE_VERSION 1
+/**
+ * @ingroup iface_zcr_remote_shell_v1
+ */
+#define ZCR_REMOTE_SHELL_V1_GET_NOTIFICATION_SURFACE_SINCE_VERSION 1
 
 /** @ingroup iface_zcr_remote_shell_v1 */
 static inline void
 zcr_remote_shell_v1_set_user_data(struct zcr_remote_shell_v1 *zcr_remote_shell_v1, void *user_data)
 {
         wl_proxy_set_user_data((struct wl_proxy *) zcr_remote_shell_v1, user_data);
 }
 
 /** @ingroup iface_zcr_remote_shell_v1 */
 static inline void *
@@ skipping 81 matching lines @@
          *
          * This is only a request that the user intends to close your
          * window. The client may choose to ignore this request, or show a
          * dialog to ask the user to save their data...
          */
         void (*close)(void *data,
                       struct zcr_remote_surface_v1 *zcr_remote_surface_v1);
         /**
          * surface state type changed
          *
-         * The state_type_changed event is sent by the compositor when
-         * the surface state changed.
+         * [Deprecated] The state_type_changed event is sent by the
+         * compositor when the surface state changed.
          *
          * This is an event to notify that the window state changed in
          * compositor. The state change may be triggered by a client's
          * request, or some user action directly handled by the compositor.
          * The client may choose to ignore this event.
          */
         void (*state_type_changed)(void *data,
                                    struct zcr_remote_surface_v1 *zcr_remote_surface_v1,
                                    uint32_t state_type);
         /**
          * suggest a surface change
          *
          * The configure event asks the client to change surface state.
          *
          * The origin arguments specify the position, in the compositor
          * coordinate space, of the virtual display used by the client to
          * simulate multiple displays. The client must offset window
          * positions in set_window_geometry requests by this origin in
          * order to convert between coordinate spaces.
          *
+         * The states listed in the event are state_type values, and might
+         * change due to a client request or an event directly handled by
+         * the compositor.
+         *
          * Clients should arrange their surface for the new state, and then
          * send an ack_configure request with the serial sent in this
          * configure event at some point before committing the new surface.
          *
          * If the client receives multiple configure events before it can
          * respond to one, it is free to discard all but the last event it
          * received.
          * @since 3
          */
         void (*configure)(void *data,
                           struct zcr_remote_surface_v1 *zcr_remote_surface_v1,
                           int32_t origin_x,
                           int32_t origin_y,
+                          struct wl_array *states,
                           uint32_t serial);
 };
 
 /**
- * @ingroup zcr_remote_surface_v1_iface
+ * @ingroup iface_zcr_remote_surface_v1
  */
 static inline int
 zcr_remote_surface_v1_add_listener(struct zcr_remote_surface_v1 *zcr_remote_surface_v1,
                                    const struct zcr_remote_surface_v1_listener *listener, void *data)
 {
         return wl_proxy_add_listener((struct wl_proxy *) zcr_remote_surface_v1,
                                      (void (**)(void)) listener, data);
 }
 
-#define ZCR_REMOTE_SURFACE_V1_DESTROY   0
-#define ZCR_REMOTE_SURFACE_V1_SET_APP_ID        1
-#define ZCR_REMOTE_SURFACE_V1_SET_WINDOW_GEOMETRY       2
-#define ZCR_REMOTE_SURFACE_V1_SET_SCALE 3
-#define ZCR_REMOTE_SURFACE_V1_SET_RECTANGULAR_SHADOW    4
-#define ZCR_REMOTE_SURFACE_V1_SET_RECTANGULAR_SHADOW_BACKGROUND_OPACITY 5
-#define ZCR_REMOTE_SURFACE_V1_SET_TITLE 6
-#define ZCR_REMOTE_SURFACE_V1_SET_TOP_INSET     7
-#define ZCR_REMOTE_SURFACE_V1_ACTIVATE  8
-#define ZCR_REMOTE_SURFACE_V1_MAXIMIZE  9
-#define ZCR_REMOTE_SURFACE_V1_MINIMIZE  10
-#define ZCR_REMOTE_SURFACE_V1_RESTORE   11
-#define ZCR_REMOTE_SURFACE_V1_FULLSCREEN        12
-#define ZCR_REMOTE_SURFACE_V1_UNFULLSCREEN      13
-#define ZCR_REMOTE_SURFACE_V1_PIN       14
-#define ZCR_REMOTE_SURFACE_V1_UNPIN     15
-#define ZCR_REMOTE_SURFACE_V1_SET_SYSTEM_MODAL  16
-#define ZCR_REMOTE_SURFACE_V1_UNSET_SYSTEM_MODAL        17
-#define ZCR_REMOTE_SURFACE_V1_SET_RECTANGULAR_SURFACE_SHADOW    18
-#define ZCR_REMOTE_SURFACE_V1_ACK_CONFIGURE     19
-#define ZCR_REMOTE_SURFACE_V1_SET_MOVING        20
-#define ZCR_REMOTE_SURFACE_V1_UNSET_MOVING      21
+#define ZCR_REMOTE_SURFACE_V1_DESTROY 0
+#define ZCR_REMOTE_SURFACE_V1_SET_APP_ID 1
+#define ZCR_REMOTE_SURFACE_V1_SET_WINDOW_GEOMETRY 2
+#define ZCR_REMOTE_SURFACE_V1_SET_SCALE 3
+#define ZCR_REMOTE_SURFACE_V1_SET_RECTANGULAR_SHADOW 4
+#define ZCR_REMOTE_SURFACE_V1_SET_RECTANGULAR_SHADOW_BACKGROUND_OPACITY 5
+#define ZCR_REMOTE_SURFACE_V1_SET_TITLE 6
+#define ZCR_REMOTE_SURFACE_V1_SET_TOP_INSET 7
+#define ZCR_REMOTE_SURFACE_V1_ACTIVATE 8
+#define ZCR_REMOTE_SURFACE_V1_MAXIMIZE 9
+#define ZCR_REMOTE_SURFACE_V1_MINIMIZE 10
+#define ZCR_REMOTE_SURFACE_V1_RESTORE 11
+#define ZCR_REMOTE_SURFACE_V1_FULLSCREEN 12
+#define ZCR_REMOTE_SURFACE_V1_UNFULLSCREEN 13
+#define ZCR_REMOTE_SURFACE_V1_PIN 14
+#define ZCR_REMOTE_SURFACE_V1_UNPIN 15
+#define ZCR_REMOTE_SURFACE_V1_SET_SYSTEM_MODAL 16
+#define ZCR_REMOTE_SURFACE_V1_UNSET_SYSTEM_MODAL 17
+#define ZCR_REMOTE_SURFACE_V1_SET_RECTANGULAR_SURFACE_SHADOW 18
+#define ZCR_REMOTE_SURFACE_V1_ACK_CONFIGURE 19
+#define ZCR_REMOTE_SURFACE_V1_MOVE 20
 
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_DESTROY_SINCE_VERSION     1
+#define ZCR_REMOTE_SURFACE_V1_CLOSE_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_SET_APP_ID_SINCE_VERSION  1
+#define ZCR_REMOTE_SURFACE_V1_STATE_TYPE_CHANGED_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_SET_WINDOW_GEOMETRY_SINCE_VERSION 1
+#define ZCR_REMOTE_SURFACE_V1_CONFIGURE_SINCE_VERSION 3
+
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_SET_SCALE_SINCE_VERSION   1
+#define ZCR_REMOTE_SURFACE_V1_DESTROY_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_SET_RECTANGULAR_SHADOW_SINCE_VERSION      1
+#define ZCR_REMOTE_SURFACE_V1_SET_APP_ID_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_SET_RECTANGULAR_SHADOW_BACKGROUND_OPACITY_SINCE_VERSION   1
+#define ZCR_REMOTE_SURFACE_V1_SET_WINDOW_GEOMETRY_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_SET_TITLE_SINCE_VERSION   1
+#define ZCR_REMOTE_SURFACE_V1_SET_SCALE_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_SET_TOP_INSET_SINCE_VERSION       1
+#define ZCR_REMOTE_SURFACE_V1_SET_RECTANGULAR_SHADOW_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_ACTIVATE_SINCE_VERSION    1
+#define ZCR_REMOTE_SURFACE_V1_SET_RECTANGULAR_SHADOW_BACKGROUND_OPACITY_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_MAXIMIZE_SINCE_VERSION    1
+#define ZCR_REMOTE_SURFACE_V1_SET_TITLE_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_MINIMIZE_SINCE_VERSION    1
+#define ZCR_REMOTE_SURFACE_V1_SET_TOP_INSET_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_RESTORE_SINCE_VERSION     1
+#define ZCR_REMOTE_SURFACE_V1_ACTIVATE_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_FULLSCREEN_SINCE_VERSION  1
+#define ZCR_REMOTE_SURFACE_V1_MAXIMIZE_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_UNFULLSCREEN_SINCE_VERSION        1
+#define ZCR_REMOTE_SURFACE_V1_MINIMIZE_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_PIN_SINCE_VERSION 1
+#define ZCR_REMOTE_SURFACE_V1_RESTORE_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_UNPIN_SINCE_VERSION       1
+#define ZCR_REMOTE_SURFACE_V1_FULLSCREEN_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_SET_SYSTEM_MODAL_SINCE_VERSION    1
+#define ZCR_REMOTE_SURFACE_V1_UNFULLSCREEN_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_UNSET_SYSTEM_MODAL_SINCE_VERSION  1
+#define ZCR_REMOTE_SURFACE_V1_PIN_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_SET_RECTANGULAR_SURFACE_SHADOW_SINCE_VERSION      2
+#define ZCR_REMOTE_SURFACE_V1_UNPIN_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_ACK_CONFIGURE_SINCE_VERSION       3
+#define ZCR_REMOTE_SURFACE_V1_SET_SYSTEM_MODAL_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_SET_MOVING_SINCE_VERSION  3
+#define ZCR_REMOTE_SURFACE_V1_UNSET_SYSTEM_MODAL_SINCE_VERSION 1
 /**
  * @ingroup iface_zcr_remote_surface_v1
  */
-#define ZCR_REMOTE_SURFACE_V1_UNSET_MOVING_SINCE_VERSION        3
+#define ZCR_REMOTE_SURFACE_V1_SET_RECTANGULAR_SURFACE_SHADOW_SINCE_VERSION 2
+/**
+ * @ingroup iface_zcr_remote_surface_v1
+ */
+#define ZCR_REMOTE_SURFACE_V1_ACK_CONFIGURE_SINCE_VERSION 3
+/**
+ * @ingroup iface_zcr_remote_surface_v1
+ */
+#define ZCR_REMOTE_SURFACE_V1_MOVE_SINCE_VERSION 3
 
 /** @ingroup iface_zcr_remote_surface_v1 */
 static inline void
 zcr_remote_surface_v1_set_user_data(struct zcr_remote_surface_v1 *zcr_remote_surface_v1, void *user_data)
 {
         wl_proxy_set_user_data((struct wl_proxy *) zcr_remote_surface_v1, user_data);
 }
 
 /** @ingroup iface_zcr_remote_surface_v1 */
 static inline void *
@@ skipping 346 matching lines @@
 static inline void
 zcr_remote_surface_v1_ack_configure(struct zcr_remote_surface_v1 *zcr_remote_surface_v1, uint32_t serial)
 {
         wl_proxy_marshal((struct wl_proxy *) zcr_remote_surface_v1,
                          ZCR_REMOTE_SURFACE_V1_ACK_CONFIGURE, serial);
 }
 
 /**
  * @ingroup iface_zcr_remote_surface_v1
  *
- * Notifies the compositor when an interactive, user-driven move of the
- * surface starts. The compositor may assume that subsequent
- * set_window_geometry requests are position updates until it receives a
- * unset_moving request.
+ * Start an interactive, user-driven move of the surface.
+ *
+ * The compositor responds to this request with a configure event that
+ * transitions to the "moving" state. The client must only initiate motion
+ * after acknowledging the state change. The compositor can assume that
+ * subsequent set_window_geometry requests are position updates until the
+ * next state transition is acknowledged.
+ *
+ * The compositor may ignore move requests depending on the state of the
+ * surface, e.g. fullscreen or maximized.
  */
 static inline void
-zcr_remote_surface_v1_set_moving(struct zcr_remote_surface_v1 *zcr_remote_surface_v1)
+zcr_remote_surface_v1_move(struct zcr_remote_surface_v1 *zcr_remote_surface_v1)
 {
         wl_proxy_marshal((struct wl_proxy *) zcr_remote_surface_v1,
-                         ZCR_REMOTE_SURFACE_V1_SET_MOVING);
+                         ZCR_REMOTE_SURFACE_V1_MOVE);
 }
 
-/**
- * @ingroup iface_zcr_remote_surface_v1
- *
- * Notifies the compositor when an interactive, user-driven move of the
- * surface stops. The compositor may choose to stop the move regardless
- * of this request.
- */
-static inline void
-zcr_remote_surface_v1_unset_moving(struct zcr_remote_surface_v1 *zcr_remote_surface_v1)
-{
-        wl_proxy_marshal((struct wl_proxy *) zcr_remote_surface_v1,
-                         ZCR_REMOTE_SURFACE_V1_UNSET_MOVING);
-}
+#define ZCR_NOTIFICATION_SURFACE_V1_DESTROY 0
 
-#define ZCR_NOTIFICATION_SURFACE_V1_DESTROY     0
 
 /**
  * @ingroup iface_zcr_notification_surface_v1
  */
-#define ZCR_NOTIFICATION_SURFACE_V1_DESTROY_SINCE_VERSION       1
+#define ZCR_NOTIFICATION_SURFACE_V1_DESTROY_SINCE_VERSION 1
 
 /** @ingroup iface_zcr_notification_surface_v1 */
 static inline void
 zcr_notification_surface_v1_set_user_data(struct zcr_notification_surface_v1 *zcr_notification_surface_v1, void *user_data)
 {
         wl_proxy_set_user_data((struct wl_proxy *) zcr_notification_surface_v1, user_data);
 }
 
 /** @ingroup iface_zcr_notification_surface_v1 */
 static inline void *
@@ skipping 20 matching lines @@
                          ZCR_NOTIFICATION_SURFACE_V1_DESTROY);
 
         wl_proxy_destroy((struct wl_proxy *) zcr_notification_surface_v1);
 }
 
 #ifdef  __cplusplus
 }
 #endif
 
 #endif