mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-06 06:20:55 -08:00
Code Issues Projects Releases Wiki Activity

low-level-key-event: Minor doc style improvement

Browse source 
* doc/lispref/commands.texi (Misc Events): Improve style and clarify
the dependence on `enable-low-level-key-events`.
* src/keyboard.c (syms_of_keyboard): Fix markup.
This commit is contained in:
Cecilio Pardo 2024-12-02 17:30:42 +01:00 • committed by Stefan Monnier
parent 4d26a17b01
commit 67aed063f6
2 changed files with 7 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

7
doc/lispref/commands.texi
View file

@ -2671,11 +2671,14 @@ size of the object beneath the gesture: image, window, etc.
@cindex @code{low-level-key} event @cindex @code{low-level-key} event
@item (low-level-key @var{is-key-press} @var{key} @var{modifier} @var{time} @var{frame}) @item (low-level-key @var{is-key-press} @var{key} @var{modifier} @var{time} @var{frame})
This event is sent on the physical press or release of keys, only on GUI This event is sent on the physical press or release of keys, only on GUI
systems, currently X, MS-Windows and PGTK. systems, currently X, MS-Windows and PGTK, and only if the variable
@code{enable-low-level-key-events} has a non-@code{nil} value. See its
documentation for the values it can take, that allow to filter which
keys should generate this kind of event.
@var{is-key-press} is @code{t} for a key press, @code{nil} for a key release. @var{is-key-press} is @code{t} for a key press, @code{nil} for a key release.
@var{time} is the event's time in milliseconds, @var{frame} is the @var{time} is the event's time in milliseconds, @var{frame} is the
frame receiving it. @var{modifier} is @code{nil} if the key is not a frame receiving it. @var{modifier} is @code{nil} if the key is not a
modifier key, @code{t} if it is, but it is unknown which one, or one of modifier key, @code{t} if it is, but it is unknown which one, or one of
@code{shift}, @code{control}, @code{meta}, @code{alt}, @code{super}, @code{shift}, @code{control}, @code{meta}, @code{alt}, @code{super},
@code{hyper}. @code{hyper}.

4
src/keyboard.c
View file

@ -13159,12 +13159,12 @@ The value configures the set of keys that are handled:
If t, send events for all keys. If t, send events for all keys.
If a number, send events for the corresponding keysym. When calling If a number, send events for the corresponding keysym. When calling
'llk-init', a set of variables with the xk- prefix is initialized with `llk-init', a set of variables with the xk- prefix is initialized with
the numeric values for keysyms. Because this number are platform the numeric values for keysyms. Because this number are platform
dependent, only the variables should be used to refer to a key. For dependent, only the variables should be used to refer to a key. For
example, the 'xk-backspace' variable refer to the backspace key, with example, the 'xk-backspace' variable refer to the backspace key, with
the numeric value 0xff08 on X, and the 0x08 on MS-Windows. You can see the numeric value 0xff08 on X, and the 0x08 on MS-Windows. You can see
all defined variables on the variable 'llk-keysyms'. all defined variables on the variable `llk-keysyms'.
If a symbol, a predefined set of keys is selected. The only currently If a symbol, a predefined set of keys is selected. The only currently
valid symbol is 'modifiers. valid symbol is 'modifiers.