third_party: Revise version 3 of remote shell protocol

third_party/wayland-protocols/unstable/remote-shell/remote-shell-unstable-v1.xml

 <?xml version="1.0" encoding="UTF-8"?>
 <protocol name="remote_shell_unstable_v1">
 
   <copyright>
     Copyright 2016 The Chromium Authors.
 
     Permission is hereby granted, free of charge, to any person obtaining a
     copy of this software and associated documentation files (the "Software"),
     to deal in the Software without restriction, including without limitation
     the rights to use, copy, modify, merge, publish, distribute, sublicense,
@@ skipping 109 matching lines @@
         Creates a notification_surface for the given surface, gives it the
         notification_surface role and associated it with a notification id.
       </description>
       <arg name="id" type="new_id" interface="zcr_notification_surface_v1"/>
       <arg name="surface" type="object" interface="wl_surface"/>
       <arg name="notification_id" type="string" />
     </request>
 
     <event name="configuration_changed">
       <description summary="suggests a re-configuration of remote shell">
-        Suggests a re-configuration of remote shell.
+        [Deprecated] Suggests a re-configuration of remote shell.
       </description>
       <arg name="width" type="int"/>
       <arg name="height" type="int"/>
       <arg name="transform" type="int"/>
       <arg name="scale_factor" type="fixed"/>
       <arg name="work_area_inset_left" type="int"/>
       <arg name="work_area_inset_top" type="int"/>
       <arg name="work_area_inset_right" type="int"/>
       <arg name="work_area_inset_bottom" type="int"/>
       <arg name="layout_mode" type="uint"/>
     </event>
+
+    <!-- Version 3 additions -->
+
+    <event name="workspace" version="3">
+      <description summary="area of remote shell">
+        Defines an area of the remote shell used for layout. Each series of
+        "workspace" events must be terminated by a "configure" event.
+      </description>
+      <arg name="id_hi" type="uint"/>
+      <arg name="id_lo" type="uint"/>
+      <arg name="x" type="int"/>
+      <arg name="y" type="int"/>
+      <arg name="width" type="int"/>
+      <arg name="height" type="int"/>
+      <arg name="inset_left" type="int"/>
+      <arg name="inset_top" type="int"/>
+      <arg name="inset_right" type="int"/>
+      <arg name="inset_bottom" type="int"/>
+    </event>
+
+    <event name="configure" version="3">
+      <description summary="suggests configuration of remote shell">
+        Suggests a new configuration of the remote shell. Preceded by a series
+        of "workspace" events.
+      </description>
+      <arg name="primary_id_hi" type="uint"/>
+      <arg name="primary_id_lo" type="uint"/>
+      <arg name="transform" type="int"/>
+      <arg name="scale_factor" type="fixed"/>
+      <arg name="layout_mode" type="uint"/>
+    </event>
   </interface>
 
   <interface name="zcr_remote_surface_v1" version="3">
     <description summary="A desktop window">
       An interface that may be implemented by a wl_surface, for
       implementations that provide a desktop-style user interface
       and allows for remotely managed windows.
 
       It provides requests to treat surfaces like windows, allowing to set
       properties like app id and geometry.
@@ skipping 247 matching lines @@
       <arg name="width" type="int"/>
       <arg name="height" type="int"/>
     </request>
 
     <!-- Version 3 additions -->
 
     <event name="configure" since="3">
       <description summary="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 client must apply the origin offset to window positions in
+        set_window_geometry requests.
 
         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.
       </description>
-      <arg name="origin_x" type="int"/>
-      <arg name="origin_y" type="int"/>
+      <arg name="origin_offset_x" type="int"/>
+      <arg name="origin_offset_y" type="int"/>
       <arg name="states" type="array"/>
       <arg name="serial" type="uint"/>
     </event>
 
     <request name="ack_configure" since="3">
       <description summary="ack a configure event">
         When a configure event is received, if a client commits the
         surface in response to the configure event, then the client
         must make an ack_configure request sometime before the commit
         request, passing along the serial of the configure event.
@@ skipping 40 matching lines @@
     </description>
 
     <request name="destroy" type="destructor">
       <description summary="Destroy the notification_surface">
         Unmap and destroy the notification surface.
       </description>
     </request>
   </interface>
 
 </protocol>