From: Po Lu <luangruo@yahoo.com>
Date: Fri, 17 Jun 2022 11:04:08 +0000 (+0800)
Subject: Clarify doc of `x-display-set-last-user-time'
X-Git-Tag: emacs-29.0.90~1447^2~1690
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=3eb47077d3d9e9e90ac7b9644d13c0da26c3ede8;p=emacs.git

Clarify doc of `x-display-set-last-user-time'

* src/xfns.c (Fx_display_last_user_time): Explain in more detail
the meaning of TERMINAL.
---

diff --git a/src/xfns.c b/src/xfns.c
index 595f3fffffa..3df91679afd 100644
--- a/src/xfns.c
+++ b/src/xfns.c
@@ -9478,7 +9478,10 @@ DEFUN ("x-display-set-last-user-time", Fx_display_last_user_time,
 TIME-OBJECT is the X server time, in milliseconds, of the last user
 interaction.  This is the timestamp that `x-get-selection-internal'
 will use by default to fetch selection data.
-TERMINAL is the terminal on which the user interaction occurred.  */)
+The optional second argument TERMINAL specifies which display to act
+on.  TERMINAL should be a terminal object, a frame or a display name
+(a string).  If TERMINAL is omitted or nil, that stands for the
+selected frame's display.  */)
   (Lisp_Object time_object, Lisp_Object terminal)
 {
   struct x_display_info *dpyinfo;