protocol: Add release (destructor) request to wl_output

Outputs come and go, and this is needed to clean up wl_resources on the
server side. All protocol objects need a way to be destroyed.

Cc: Neil Roberts <neil@linux.intel.com>
Cc: Jason Ekstrand <jason@jlekstrand.net>
Signed-off-by: Quentin Glidic <sardemff7+git@sardemff7.net>
Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
Reviewed-by: Yong Bakos <ybakos@humanoriented.com>
[Pekka: added commit message]

diff --git a/protocol/wayland.xml b/protocol/wayland.xml
index 700ef03..0830afc 100644 (file)
--- a/protocol/wayland.xml
+++ b/protocol/wayland.xml
@@ -2264,7 +2264,7 @@
     </request>
   </interface>
 
-  <interface name="wl_output" version="2">
+  <interface name="wl_output" version="3">
     <description summary="compositor output region">
       An output describes part of the compositor geometry.  The
       compositor works in the 'compositor coordinate system' and an
@@ -2369,6 +2369,8 @@
       <arg name="refresh" type="int" summary="vertical refresh rate in mHz"/>
     </event>
 
+    <!-- Version 2 additions -->
+
     <event name="done" since="2">
       <description summary="sent all information about output">
         This event is sent after all other properties have been
@@ -2402,6 +2404,15 @@
       </description>
       <arg name="factor" type="int" summary="scaling factor of output"/>
     </event>
+
+    <!-- Version 3 additions -->
+
+    <request name="release" type="destructor" since="3">
+      <description summary="release the output object">
+       Using this request a client can tell the server that it is not going to
+       use the output object anymore.
+      </description>
+    </request>
   </interface>
 
   <interface name="wl_region" version="1">