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

; Improve recently installed documentation

Browse source 
* etc/NEWS: Fix a typo.

* doc/lispref/commands.texi (Touchscreen Events): Fix wording and
indexing.
This commit is contained in:
Eli Zaretskii 2021-12-17 17:06:32 +02:00
parent ccb6028364
commit 749c465a09
2 changed files with 11 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

21
doc/lispref/commands.texi
View file

@ -1842,18 +1842,18 @@ as the mouse cursor remains pointing to the same glyph in the text.
@cindex support for touchscreens
Some window systems provide support for input devices that react to
the user's finger, and translate those finger movements into points at
an on-screen position. These input devices are known as touchscreens,
and Emacs reports the movements they generate as @dfn{touchscreen
events}.
the user's touching the screen and moving fingers while touching the
screen. These input devices are known as touchscreens, and Emacs
reports the events they generate as @dfn{touchscreen events}.
Most individual events generated by a touchscreen only have meaning as
part of a larger sequence of other events: for instance, the simple
operation of tapping the touchscreen involves the user placing and
releasing a finger on the touchscreen, and swiping the display to
raising a finger on the touchscreen, and swiping the display to
scroll it involves placing a finger, moving it many times upwards or
downwards, and then releasing the finger.
downwards, and then raising the finger.
@cindex touch point, in touchscreen events
While a simplistic model consisting of one finger is adequate for taps
and scrolling, more complicated gestures require support for keeping
track of multiple fingers, where the position of each finger is
@ -1864,7 +1864,6 @@ positions of their individual points determine the amount by which to
zoom the display, and the center of an imaginary line between those
positions determines where to pan the display after zooming.
@cindex touch point representation
The low-level touchscreen events described below can be used to
implement all the touch sequences described above. In those events,
each point is represented by a cons of an arbitrary number identifying
@ -1879,15 +1878,15 @@ finger against the touchscreen.
@cindex @code{touchscreen-update} event
@item (touchscreen-update @var{points})
This event is sent when an point on the touchscreen has changed
position. @var{points} is a list of touchpoints containing the
up-to-date positions of each touchpoint currently on the touchscreen.
This event is sent when a point on the touchscreen has changed
position. @var{points} is a list of touch points containing the
up-to-date positions of each touch point currently on the touchscreen.
@cindex @code{touchscreen-end} event
@item (touchscreen-end @var{point})
This event is sent when @var{point} is no longer present on the
display, because another program took the grab, or because the user
released the finger.
raised the finger from the touchscreen.
@end table
@node Focus Events

2
etc/NEWS
View file

@ -1164,7 +1164,7 @@ assumes a time of 00:00 instead of signaling an error.
+++
** New events for taking advantage of touchscreen devices.
The events 'touchscreen-down', 'touchscreen-update' and
The events 'touchscreen-begin, 'touchscreen-update', and
'touchscreen-end' have been added to take better advantage of
touch-capable display panels.