]> git.eshelyaron.com Git - emacs.git/commitdiff
Improve documentation of wheel events
authorPo Lu <luangruo@yahoo.com>
Sat, 27 Nov 2021 11:14:43 +0000 (19:14 +0800)
committerPo Lu <luangruo@yahoo.com>
Sat, 27 Nov 2021 12:48:25 +0000 (20:48 +0800)
* doc/lispref/commands.texi (Misc Events): Add missing
parameters to `wheel-up' and `wheel-down'.

doc/lispref/commands.texi

index c12a97cc7df79fc3729269586a63f74e6b168fbe..86f84684b4625923e299097c8d57ea4f0dfc8b80 100644 (file)
@@ -1995,15 +1995,19 @@ frame has already been made visible, Emacs has no work to do.
 
 @cindex @code{wheel-up} event
 @cindex @code{wheel-down} event
-@item (wheel-up @var{position})
-@itemx (wheel-down @var{position})
+@item (wheel-up @var{position} @var{clicks} @var{lines} @var{pixel-delta})
+@itemx (wheel-down @var{position} @var{clicks} @var{lines} @var{pixel-delta})
 These kinds of event are generated by moving a mouse wheel.  The
 @var{position} element is a mouse position list (@pxref{Click
 Events}), specifying the position of the mouse cursor when the event
-occurred.  The event may have additional arguments after
-@var{position}.  The third argument after @var{position}, if present,
-is a pair of the form @w{@code{(@var{x} . @var{y})}}, where @var{x}
-and @var{y} are the number of pixels to scroll by in each axis.
+occurred.
+
+@var{clicks}, if present, is the number of times in quick succession
+the wheel has been moved.  @xref{Repeat Events}.  @var{lines}, if
+present and not @code{nil}, is the number of screen lines that should
+be scrolled.  @var{pixel-delta}, if present, is a pair of the form
+@w{@code{(@var{x} . @var{y})}}, where @var{x} and @var{y} are the
+number of pixels to scroll by in each axis.
 
 @cindex pixel-resolution wheel events
 You can use @var{x} and @var{y} to determine how much the mouse wheel