emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

master 8f43180: Improve documentation of 'inhibit-mouse-event-check'


From: Eli Zaretskii
Subject: master 8f43180: Improve documentation of 'inhibit-mouse-event-check'
Date: Mon, 23 Aug 2021 15:14:58 -0400 (EDT)

branch: master
commit 8f43180f0dc5b3e25d8252950ea63e2e92d40611
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>

    Improve documentation of 'inhibit-mouse-event-check'
    
    * etc/NEWS:
    * src/callint.c (syms_of_callint): Fix wording of the
    documentation of 'inhibit-mouse-event-check'.
---
 etc/NEWS      | 6 +++---
 src/callint.c | 9 +++++----
 2 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/etc/NEWS b/etc/NEWS
index ed77443..588290f 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -3848,9 +3848,9 @@ current buffer will be shown first in the "*xref*" buffer.
 
 ---
 ** New variable 'inhibit-mouse-event-check'.
-If bound to non-nil, a command with '(interactive "e")'
-doesn't signal an error when no mouse event is produced
-while using the keyboard.
+If bound to non-nil, a command with '(interactive "e")' doesn't signal
+an error when invoked by input event that is not a mouse click (e.g.,
+a key sequence).
 
 
 * Changes in Emacs 28.1 on Non-Free Operating Systems
diff --git a/src/callint.c b/src/callint.c
index 5201dc7..44dae36 100644
--- a/src/callint.c
+++ b/src/callint.c
@@ -901,10 +901,11 @@ a way to turn themselves off when a mouse command 
switches windows.  */);
   Vmouse_leave_buffer_hook = Qnil;
 
   DEFVAR_BOOL ("inhibit-mouse-event-check", inhibit_mouse_event_check,
-    doc: /* Non-nil means the interactive spec "e" doesn't check for events.
-In this case `(interactive "e")' doesn't signal an error when no mouse event
-is produced while using the keyboard.  Then `event-start', `event-end',
-`event-click-count' can create a new event.  */);
+    doc: /* Whether the interactive spec "e" requires a mouse gesture event.
+If non-nil, `(interactive "e")' doesn't signal an error when the command
+was invoked by an input event that is not a mouse gesture: a click, a drag,
+etc.  To create the event data when the input was some other event,
+use `event-start', `event-end', and `event-click-count'.  */);
   inhibit_mouse_event_check = false;
 
   defsubr (&Sinteractive);



reply via email to

[Prev in Thread] Current Thread [Next in Thread]