Let clients set _NET_WM_USER_TIME for initial window(s) too

(http://mail.gnome.org/archives/wm-spec-list/2005-January/msg00001.html)

1 files changed, 15 insertions, 11 deletions

diff --git a/wm-spec/wm-spec.xml b/wm-spec/wm-spec.xml
index 0cc1e3a..75052f9 100644
--- a/wm-spec/wm-spec.xml
+++ b/wm-spec/wm-spec.xml
@@ -1360,17 +1360,21 @@ This property contains the XServer time at which last user activity in this
 window took place.
         </para>
         <para>
-Clients should keep the last timestamp from user interaction. and set
-this timestamp in this property on every new toplevel window before mapping it.
-A client that only deals with core events, might, for example, use the
-timestamp of the last KeyPress or ButtonPress event. ButtonRelease and KeyRelease
-events should not generally be considered to be user interaction, because an application
-may receive KeyRelease events from global keybindings, and generally release events
-may have later timestamp than actions that were triggered by the matching press events.
-Clients should start setting the property 
-only after receiving the first event from user interaction, they shouldn't set
-it before receiving first input event. The special value of zero on a newly
-mapped window means that the window shouldn't initially get focus after being mapped.
+Clients should set this property on every new toplevel window, before mapping
+the window, to the timestamp of the user interaction that caused the window to
+appear.  A client that only deals with core events, might, for example, use the
+timestamp of the last KeyPress or ButtonPress event. ButtonRelease and
+KeyRelease events should not generally be considered to be user interaction,
+because an application may receive KeyRelease events from global keybindings,
+and generally release events may have later timestamp than actions that were
+triggered by the matching press events.  Clients can obtain the timestamp that
+caused its first window to appear from the DESKTOP_STARTUP_ID environment
+variable, if the app was launched with startup notification.  If the client does
+not know the timestamp of the user interaction that caused the first window to
+appear (e.g. because it was not launched with startup notification), then it
+should not set the property for that window.  The special value of zero on a
+newly mapped window can be used to request that the window not be initially
+focused when it is mapped.
         </para>
         <para>
 If the client has the active window, it should also update this property