From: Eli Zaretskii Date: Mon, 23 Aug 2021 19:14:03 +0000 (+0300) Subject: Improve documentation of 'inhibit-mouse-event-check' X-Git-Tag: emacs-28.0.90~1333 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=8f43180f0dc5b3e25d8252950ea63e2e92d40611;p=emacs.git 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'. --- diff --git a/etc/NEWS b/etc/NEWS index ed77443dbf0..588290f433e 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 5201dc7ba16..44dae361c1f 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);