Re: Re: Add _NET_WM_STATE_FOCUSED to _NET_WM_STATE

[Rui Tiago Cação Matos <tiagomatos gmail com>]

On 31 October 2011 08:51, Giles Atkinson <Giles Atkinson eu citrix com> wrote:
> Now that this has been fully explained, it makes a lot of sense - at least to me.  But that information should have been available in the patch, which shares a common fault of almost all software documentation: no description of purpose or semantics.

Yes, I apologize for that. I've simplified the previous text and added
your paragraph at the end:

	<para>
_NET_WM_STATE_FOCUSED indicates whether window decorations are drawn in an
active state. Clients MUST regard it as a read only hint which they can't
change. The window given by _NET_ACTIVE_WINDOW will usually have this hint,
but at times other windows may as well, if they have a strong association with
the active window and will be considered as a unit with it by the
user. Clients that modify the appearance of internal elements when they expect
to receive input (keyboard or mouse) SHOULD use this indication in preference
to FocusIn or EnterNotify events, when it is available. By doing so they will
accurately reflect the intentions of the Window Manager.
	</para>

Do we agree on this?

Thanks,
Rui

diff --git a/wm-spec-1.4.xml b/wm-spec-1.4.xml
index 98f9f9b..25ff54e 100644
--- a/wm-spec-1.4.xml
+++ b/wm-spec-1.4.xml
@@ -1117,6 +1117,7 @@ _NET_WM_STATE_FULLSCREEN, ATOM
 _NET_WM_STATE_ABOVE, ATOM
 _NET_WM_STATE_BELOW, ATOM
 _NET_WM_STATE_DEMANDS_ATTENTION, ATOM
+_NET_WM_STATE_FOCUSED, ATOM
 ]]></programlisting>
       <para>
 An implementation MAY add new atoms to this list. Implementations
@@ -1207,6 +1208,18 @@ the window got the required attention (usually, that it got activated).
 	</para>
 
 	<para>
+_NET_WM_STATE_FOCUSED indicates whether window decorations are drawn in an
+active state. Clients MUST regard it as a read only hint which they can't
+change. The window given by _NET_ACTIVE_WINDOW will usually have this hint,
+but at times other windows may as well, if they have a strong association with
+the active window and will be considered as a unit with it by the
+user. Clients that modify the appearance of internal elements when they expect
+to receive input (keyboard or mouse) SHOULD use this indication in preference
+to FocusIn or EnterNotify events, when it is available. By doing so they will
+accurately reflect the intentions of the Window Manager.
+	</para>
+
+	<para>
 To change the state of a mapped window, a Client MUST send a _NET_WM_STATE
 client message to the root window:
 	</para>
@@ -2267,6 +2280,9 @@ Added _NET_WM_FULL_PLACEMENT.
 			<listitem><para>
 Added _NET_WM_FULLSCREEN_MONITORS.
 			</para></listitem>
+			<listitem><para>
+Added _NET_WM_STATE_FOCUSED.
+			</para></listitem>
 	        </itemizedlist>
             </sect2>
  	    <sect2>