summaryrefslogtreecommitdiff
path: root/spec/generic-types.xml
diff options
context:
space:
mode:
authorSimon McVittie <simon.mcvittie@collabora.co.uk>2010-05-25 15:45:24 +0100
committerSimon McVittie <simon.mcvittie@collabora.co.uk>2010-05-25 16:01:09 +0100
commit2948ab95e843a969840d9e2696103e9b63282c92 (patch)
tree0d7461643c8a39671c3b2062b5e6f5dd856b80ef /spec/generic-types.xml
parentfc4cf185b4528a582c5f2eb2efeb0cc60509371a (diff)
downloadtelepathy-glib-2948ab95e843a969840d9e2696103e9b63282c92.tar.gz
Update to spec 0.19.6
Diffstat (limited to 'spec/generic-types.xml')
-rw-r--r--spec/generic-types.xml30
1 files changed, 30 insertions, 0 deletions
diff --git a/spec/generic-types.xml b/spec/generic-types.xml
index d4dce1552..c017ba595 100644
--- a/spec/generic-types.xml
+++ b/spec/generic-types.xml
@@ -165,4 +165,34 @@
</tp:member>
</tp:struct>
+ <tp:simple-type name="User_Action_Timestamp" type="x">
+ <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+ <p>The time at which an user action occurred. This type has the 2
+ following special values:</p>
+
+ <p>0: the action doesn't involve any user action. Clients
+ SHOULD avoid stealing focus when presenting the channel.</p>
+
+ <p>MAX_INT64: clients SHOULD behave as though the user action happened
+ at the current time, e.g. a client MAY request that its window gains
+ focus.
+ </p>
+
+ <tp:rationale>
+ <p>This can be used by clients that can't know the X server time like
+ command line applications for example.</p>
+ </tp:rationale>
+
+ <p>For all the other values it corresponds to the time of the user
+ action. Clients SHOULD use this for focus-stealing prevention,
+ if applicable.
+ Note that the time is dependant on the local
+ environment and so is not necessarily a wall-clock time.
+ For example in an X environment it's expected to be the X timestamp
+ of events.
+ This corresponds to the _NET_WM_USER_TIME property in
+ <a href="http://standards.freedesktop.org/wm-spec/wm-spec-latest.html">EWMH</a>.</p>
+ </tp:docstring>
+ </tp:simple-type>
+
</tp:generic-types>