What is an "input event"?

What is an "input event"?

[Stefan Monnier]

Looking at the doc of last-repeatable-command I think we should clarify
what we mean by "input event".  The docstring says:

    Last command that may be repeated.
    The last command executed that was not bound to an input event.
    This is the command ‘repeat’ will try to repeat.
    Taken from a previous value of ‘real-this-command’.

and the manual says:

    This variable stores the most recently executed command that was not
    part of an input event.  This is the command @code{repeat} will try to
    repeat, @xref{Repeating,,, emacs, The GNU Emacs Manual}.

but according to the source code, this variable holds the last command
that was run via a "simple" event such as a keyboard key rather than
a "complex" event like a mouse click (the test is simply CONSP).

Do we somewhere define "input event" to mean an event with parameters?
I thought keyboard keys are also "input events".


        Stefan

Re: What is an "input event"?

[martin rudalics]

 > Looking at the doc of last-repeatable-command I think we should clarify
 > what we mean by "input event".  The docstring says:
 >
 >      Last command that may be repeated.
 >      The last command executed that was not bound to an input event.
 >      This is the command ‘repeat’ will try to repeat.
 >      Taken from a previous value of ‘real-this-command’.
 >
 > and the manual says:
 >
 >      This variable stores the most recently executed command that was not
 >      part of an input event.  This is the command @code{repeat} will try to
 >      repeat, @xref{Repeating,,, emacs, The GNU Emacs Manual}.
 >
 > but according to the source code, this variable holds the last command
 > that was run via a "simple" event such as a keyboard key rather than
 > a "complex" event like a mouse click (the test is simply CONSP).
 >
 > Do we somewhere define "input event" to mean an event with parameters?
 > I thought keyboard keys are also "input events".

IIRC this was to avoid repeating commands like 'handle-switch-frame'.
How should we verbally distinguish such commands from the ones we want
to consider repeatable?

martin

Re: What is an "input event"?

[Eli Zaretskii]

> From: Stefan Monnier <monnier@iro.umontreal.ca>
> Date: Wed, 21 Nov 2018 11:12:15 -0500
> 
> Looking at the doc of last-repeatable-command I think we should clarify
> what we mean by "input event".  The docstring says:
> 
>     Last command that may be repeated.
>     The last command executed that was not bound to an input event.
>     This is the command ‘repeat’ will try to repeat.
>     Taken from a previous value of ‘real-this-command’.
> 
> and the manual says:
> 
>     This variable stores the most recently executed command that was not
>     part of an input event.  This is the command @code{repeat} will try to
>     repeat, @xref{Repeating,,, emacs, The GNU Emacs Manual}.
> 
> but according to the source code, this variable holds the last command
> that was run via a "simple" event such as a keyboard key rather than
> a "complex" event like a mouse click (the test is simply CONSP).
> 
> Do we somewhere define "input event" to mean an event with parameters?

"Input Events" in the ELisp manual.  Which describes quite a few
classes of input events.

> I thought keyboard keys are also "input events".

Yes, keyboard input also counts as input events.

Those documentation parts should say "non-keyboard input events", or
something like that.