procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

; Document input-event-functions

Browse source
This commit is contained in:
Phillip Lord 2019-01-25 08:59:06 +00:00
parent f52de87166
commit 27fffb2701
2 changed files with 14 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
doc/lispref/commands.texi
View file

@ -256,7 +256,7 @@ It may be a Lisp expression that is not a string; then it should be a
form that is evaluated to get a list of arguments to pass to the
command. Usually this form will call various functions to read input
from the user, most often through the minibuffer (@pxref{Minibuffers})
or directly from the keyboard (@pxref{Reading Input}).
or directly from the keyboard (@pxref{Reading Input})
Providing point or the mark as an argument value is also common, but
if you do this @emph{and} read input (whether using the minibuffer or
@ -2920,6 +2920,18 @@ this expression) remains the value of @code{last-command-event}.
@end example
@end defvar
@defvar input-event-functions
This variable holds a list of functions to call after Emacs reads an
event, but before any commands are run. Each function recieves a
single argument: the event that has been read.
There are normally easier hooks to use than this; in particular
@var{pre-command-hook} is run immediately before any command resulting
from an event. However, not all events result in a command, including
many mouse events and some keyboard events when an input-method is
active (@pxref{Reading Input}).
@end defvar
@defmac while-no-input body@dots{}
This construct runs the @var{body} forms and returns the value of the
last one---but only if no input arrives. If any input arrives during

1
etc/NEWS
View file

@ -1204,6 +1204,7 @@ removed.
** 'lookup-key' can take a list of keymaps as argument.
+++
** New hook 'input-event-functions' run whenever a user-input is read.
+++