wsp.4: fix style warnings. No content changes.

This commit is contained in:
Christian Brueffer
2025-06-13 22:42:56 +02:00
parent b3168306a1
commit 3353f39cfc
+44 -26
View File
@@ -55,51 +55,58 @@ A single-finger press generates a left button click.
A two-finger press maps to the right button; whereas a three-finger A two-finger press maps to the right button; whereas a three-finger
press gets treated as a middle button click. press gets treated as a middle button click.
.Pp .Pp
The trackpad functions with presses and taps. A press is a full-forced The trackpad functions with presses and taps.
press which causes a physical lowering of the trackpad. A tap is a A press is a full-forced
press which causes a physical lowering of the trackpad.
A tap is a
touch of the trackpad which does not depress the physical trackpad. touch of the trackpad which does not depress the physical trackpad.
.Pp .Pp
The The
.Nm .Nm
driver supports receiving evdev input device data if enabled. This data driver supports receiving evdev input device data if enabled.
This data
is used for extended usage of the touchpad like multi-finger support, is used for extended usage of the touchpad like multi-finger support,
pressure detection, tap support, and gestures. At least the second bit pressure detection, tap support, and gestures.
of the At least the second bit of the
.Xr sysctl 8 .Xr sysctl 8
tunable tunable
.Va kern.evdev.rcpt_mask .Va kern.evdev.rcpt_mask
must be set. This can be enabled with must be set.
This can be enabled with
.Va kern.evdev.rcpt_mask=3 . .Va kern.evdev.rcpt_mask=3 .
.Pp .Pp
Vertical scrolling (z-axis) is enabled by default with a two-finger Vertical scrolling (z-axis) is enabled by default with a two-finger
tap and the movement of a finger up and down. tap and the movement of a finger up and down.
Horizontal scrolling (t-axis) is not natively supported by the sysmouse Horizontal scrolling (t-axis) is not natively supported by the sysmouse
protocol, therefore must be enabled with evdev data. This can be enabled protocol, therefore must be enabled with evdev data.
with the This can be enabled with the
.Xr sysctl 8 .Xr sysctl 8
tunable tunable
.Va kern.evdev.sysmouse_t_axis=3 . .Va kern.evdev.sysmouse_t_axis=3 .
Horizontal scrolling can be used with a two-finger tap and the movement Horizontal scrolling can be used with a two-finger tap and the movement
of a finger from side to side. The of a finger from side to side.
The
.Xr sysctl 8 .Xr sysctl 8
tunable tunable
.Va hw.usb.wsp.t_factor .Va hw.usb.wsp.t_factor
must be greater than 0 for horizontal scrolling to be enabled, too. must be greater than 0 for horizontal scrolling to be enabled, too.
.Pp .Pp
Horizontal swiping with a three-finger tap is registered as mouse buttons Horizontal swiping with a three-finger tap is registered as mouse buttons
8 and 9, depending on the direction. These buttons default to backwards 8 and 9, depending on the direction.
and forwards keyboard events. These buttons default to backwards and forwards keyboard events.
.Sh SYSCTL VARIABLES .Sh SYSCTL VARIABLES
The following variables are available as The following variables are available as
.Xr sysctl 8 .Xr sysctl 8
tunables: tunables:
.Bl -tag -width indent .Bl -tag -width indent
.It Va hw.usb.wsp.scale_factor .It Va hw.usb.wsp.scale_factor
Controls the pointer sensitivity. Default is 12. Controls the pointer sensitivity.
Default is 12.
.El .El
.Bl -tag -width indent .Bl -tag -width indent
.It Va hw.usb.wsp.enable_single_tap_clicks .It Va hw.usb.wsp.enable_single_tap_clicks
Enables single-tap to register as a left-click. Default is 1 (enabled). Enables single-tap to register as a left-click.
Default is 1 (enabled).
.El .El
.Bl -tag -width indent .Bl -tag -width indent
.It Va hw.usb.wsp.enable_single_tap_movement .It Va hw.usb.wsp.enable_single_tap_movement
@@ -114,45 +121,55 @@ finger (a lower value is used for palm detection). Default is 1900.
.Bl -tag -width indent .Bl -tag -width indent
.It Va max_scroll_finger_distance .It Va max_scroll_finger_distance
Specifies the maximum distance between two fingers where z-axis Specifies the maximum distance between two fingers where z-axis
and t-axis movements are registered. Z-axis and T-axis movements and t-axis movements are registered.
Z-axis and T-axis movements
are vertical and horizontal movements with more than one finger are vertical and horizontal movements with more than one finger
tapped (not clicked), respectively. Default is 8192. tapped (not clicked), respectively.
Default is 8192.
.El .El
.Bl -tag -width indent .Bl -tag -width indent
.It Va hw.usb.wsp.max_double_tap_distance .It Va hw.usb.wsp.max_double_tap_distance
Specifies the maximum distance between two fingers that a two-finger Specifies the maximum distance between two fingers that a two-finger
click will be registered as a right-click. Default is 2500. click will be registered as a right-click.
Default is 2500.
.El .El
.Bl -tag -width indent .Bl -tag -width indent
.It Va hw.usb.wsp.scr_threshold .It Va hw.usb.wsp.scr_threshold
Specifies the minimum horizontal or vertical distance required to Specifies the minimum horizontal or vertical distance required to
register as a scrolling gesture. Default is 20. register as a scrolling gesture.
Default is 20.
.El .El
.Bl -tag -width indent .Bl -tag -width indent
.It Va hw.usb.wsp.z_factor .It Va hw.usb.wsp.z_factor
Z-axis sensitivity. Default is 5. Z-axis sensitivity.
Default is 5.
.El .El
.Bl -tag -width indent .Bl -tag -width indent
.It Va hw.usb.wsp.z_invert .It Va hw.usb.wsp.z_invert
Z-axis inversion. Default is 0 (disabled). Z-axis inversion.
Default is 0 (disabled).
.El .El
.Bl -tag -width indent .Bl -tag -width indent
.It Va hw.usb.wsp.t_factor .It Va hw.usb.wsp.t_factor
T-axis sensitivity. Default is 0 (disabled). T-axis sensitivity.
Default is 0 (disabled).
.El .El
.Bl -tag -width indent .Bl -tag -width indent
.It Va hw.usb.wsp.t_invert .It Va hw.usb.wsp.t_invert
T-axis inversion. Default is 0 (disabled). T-axis inversion.
Default is 0 (disabled).
.El .El
.Bl -tag -width indent .Bl -tag -width indent
.It Va hw.usb.wsp.scroll_finger_count .It Va hw.usb.wsp.scroll_finger_count
Specifies the number of tapped fingers which registers as a scrolling Specifies the number of tapped fingers which registers as a scrolling
movement. Default is 2. movement.
Default is 2.
.El .El
.Bl -tag -width indent .Bl -tag -width indent
.It Va hw.usb.wsp.horizontal_swipe_finger_count .It Va hw.usb.wsp.horizontal_swipe_finger_count
Speifies the number of tapped fingers which registers as a swipe Speifies the number of tapped fingers which registers as a swipe
gesture. Default is 3. gesture.
Default is 3.
.El .El
.Bl -tag -width indent .Bl -tag -width indent
.It Va hw.usb.wsp.pressure_touch_threshold .It Va hw.usb.wsp.pressure_touch_threshold
@@ -173,7 +190,9 @@ Default is 120.
.It Va hw.usb.wsp.debug .It Va hw.usb.wsp.debug
Specifies the Specifies the
.Nm .Nm
driver debugging level (0-3). Default is 1. driver debugging level (0-3).
Default is 1.
.El
.Sh FILES .Sh FILES
.Nm .Nm
creates a blocking pseudo-device file, creates a blocking pseudo-device file,
@@ -184,8 +203,7 @@ or
.Em mousesystems .Em mousesystems
type device--see type device--see
.Xr moused 8 .Xr moused 8
for an explanation of these mouse for an explanation of these mouse types.
types.
.Sh SEE ALSO .Sh SEE ALSO
.Xr sysmouse 4 , .Xr sysmouse 4 ,
.Xr usb 4 , .Xr usb 4 ,