From 02ecba2212baf99a00cd35be9025ec359bf5e777 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Martin Gräßlin?= <mgraesslin kde org>
Date: Mon, 30 Jun 2014 15:47:11 +0200
Subject: [PATCH 2/2] _NET_WM_TITLEBAR_ACTION

Adding a new client message _NET_WM_TITLEBAR_ACTION which can
be used by Clients to request the window manager to perform an action
when a button is pressed on the title bar area of a window.
The rational is to integrate Clients using client-side-decorations
better into the environment they are running in. So instead of
performing an action like raise/lower on middle click the task is
delegated to the window manager. The window manager can then perform
the same action as it does for windows it decorates.
---
 wm-spec/wm-spec.xml | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/wm-spec/wm-spec.xml b/wm-spec/wm-spec.xml
index 8ee5315..1b683ea 100644
--- a/wm-spec/wm-spec.xml
+++ b/wm-spec/wm-spec.xml
@@ -1820,6 +1820,44 @@ the window manager can position the menu in an adjacent way. However it is up to
 the window manager on how to position the menu.
         </para>
     </sect2>
+    <sect2>
+        <title>_NET_WM_TITLEBAR_ACTION</title>
+        <para>
+By including this hint in _NET_SUPPORTED the Window Manager announces
+that it supports performing pointer button specific events. For example a window
+manager might raise or lower a Client when the decoration is middle clicked or show
+a window menu on right click. A Client drawing it's own window decoration instead of
+relying on the window manager provided decoration should use this client message
+whenever the user clicked on the title bar area. However, the handling of left
+mouse button to trigger move/resize mode must not be passed to the window manager
+as the window manager cannot know in which areas a move or resize should be started.
+Also widget areas like a close or maximize button must not be passed to the window
+manager with this client message. Instead the appropriate action as described in this
+specification should be used.
+        </para>
+        <para>
+It is up to the window manager to decide which action to perform when receiving this
+client message. An appropriate action is also to ignore the request.
+        </para>
+        <para>
+A Client can request that the window manger should perform the appropriate action by
+sending a _NET_WM_TITLEBAR_ACTION client message to the root window:
+        </para>
+        <programlisting><![CDATA[
+_NET_WM_TITLEBAR_ACTION
+  message_type = _NET_WM_TITLEBAR_ACTION
+  window = window for which the action should be performed
+  format = 32
+  data.l[0] = xinput2_device_id
+  data.l[1] = root_x
+  data.l[2] = root_y
+  data.l[3] = button
+  data.l[4] = timestamp
+]]></programlisting>
+        <para>
+Button takes the special value of 0 which indicates a double click on the title bar area.
+        </para>
+    </sect2>
 </sect1>

 <sect1>
@@ -2336,6 +2374,9 @@ OR OTHER DEALINGS IN THE SOFTWARE.
 		<title>Changes since 1.4draft</title>
 		<itemizedlist>
 			<listitem><para>
+Added _NET_WM_TITLEBAR_ACTION
+			</para></listitem>
+			<listitem><para>
 Added _NET_WM_SHOW_WINDOW_MENU
 			</para></listitem>
 			<listitem><para>
--
2.0.0