From nobody Fri Jun 13 20:43:52 2025 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4bJrw90nFgz515c5; Fri, 13 Jun 2025 20:43:53 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4bJrw86b48z3FQ5; Fri, 13 Jun 2025 20:43:52 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1749847432; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=+hQDE9o8aRy5gxoK/wn4l6wGyZ+XeQXbNQYDUsxO56c=; b=KjTWBg2UW4HC6Ad7PYSkr5bDe3DQaLNGhjr0g9ebZDcG/yHI6OlY2PBsZPQelt4fD0sXFv wz9mSwuLKRnyQpMO7dtauM5dhpZ/oilzLAMtkvIZ9/QQrhzx6t+y1kl3w8gXAVuSX1KqmC PA7/4rJqXlDlOEfh3gKrGmhnp5TbLJ9FsuZ9+tUzScm37PHKCNW/kpCEsX4BYKhEYV6Z4S qDFYwbkyh1LvcidHg8dAAwjBQz/PNi+OVvCcF18UBgAOEVYDnItrS6n7xKDZO/yHeoodGo B0U3Z60TrNqyyvsx1CyDJYka2G0BK5HfZFswc08leEY4A220/grr2VYPFl0gVA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1749847432; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=+hQDE9o8aRy5gxoK/wn4l6wGyZ+XeQXbNQYDUsxO56c=; b=nZCsZm6qBxWRPsGzlKltzdRZn3A5xD6XsKuacn6rcAI4ETs5Ld3A0GRZlKGJ3LIKeQThdu QkVeSgEBkVuDr7udBPHJRyPkjygQYWpu4Lhot4eBrQ6OQEvYveQs72BxFj5fpKDsdHINu2 Xmk8P2b+ckZhNlIeXZV7yGi3NXqZOELM1XhN6616x2uTJEsVCakCcjA57OKHPtpAYbmX1b pmaHFIlQ1XxzP5hwDBoFK242cAjMB3F/lWRXJKZQFdfGqfBGPff6xQ/wKf04HcQYtgI3ki +bLwu8KX7MVz0yPLOt/AQvfd6geLnH7QADdtercZr3HoETCF8/Xn0c9KXak22Q== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1749847432; a=rsa-sha256; cv=none; b=SGbcHBqG11zXUEli8c8PagdBVngEnDIE+TBunkewZTQa6v2esH9XVOmSEEmgXy7nbc/X26 39mYITsnr7U87sWZgKUm7V18WMoZpIyTSHv3TL0vWFE1hze3FvfS0Uqtf6kNoEndPsd7pE /WVXaztQua7IRO17zke7frSqQSa8UWHaUjmmmOolnm+/tgLWwJt3tnZQfocV8CM6t3AiGK UxoFBk6Ac97nCNfRhjiaWgfz05+jTmx8TZARYjxWfp6gBIBAga2jrHP4ybHvr6SYFNvKaE r0pAXm/OtEoYnJnSsbbSOkTX4LEfx5fyIWPPPDfqXBauHvHnhNyR4a2iLYMoxQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4bJrw86BHXz1C2X; Fri, 13 Jun 2025 20:43:52 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 55DKhq1d067543; Fri, 13 Jun 2025 20:43:52 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 55DKhq9q067540; Fri, 13 Jun 2025 20:43:52 GMT (envelope-from git) Date: Fri, 13 Jun 2025 20:43:52 GMT Message-Id: <202506132043.55DKhq9q067540@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Christian Brueffer Subject: git: 3353f39cfcad - main - wsp.4: fix style warnings. No content changes. List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: brueffer X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 3353f39cfcad4015e5741cd4976c650080828482 Auto-Submitted: auto-generated The branch main has been updated by brueffer: URL: https://cgit.FreeBSD.org/src/commit/?id=3353f39cfcad4015e5741cd4976c650080828482 commit 3353f39cfcad4015e5741cd4976c650080828482 Author: Christian Brueffer AuthorDate: 2025-06-13 20:42:56 +0000 Commit: Christian Brueffer CommitDate: 2025-06-13 20:42:56 +0000 wsp.4: fix style warnings. No content changes. --- share/man/man4/wsp.4 | 72 ++++++++++++++++++++++++++++++++-------------------- 1 file changed, 45 insertions(+), 27 deletions(-) diff --git a/share/man/man4/wsp.4 b/share/man/man4/wsp.4 index b08449f9e71f..50ada937e104 100644 --- a/share/man/man4/wsp.4 +++ b/share/man/man4/wsp.4 @@ -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 press gets treated as a middle button click. .Pp -The trackpad functions with presses and taps. A press is a full-forced -press which causes a physical lowering of the trackpad. A tap is a +The trackpad functions with presses and taps. +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. .Pp The .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, -pressure detection, tap support, and gestures. At least the second bit -of the +pressure detection, tap support, and gestures. +At least the second bit of the .Xr sysctl 8 tunable .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 . .Pp Vertical scrolling (z-axis) is enabled by default with a two-finger tap and the movement of a finger up and down. Horizontal scrolling (t-axis) is not natively supported by the sysmouse -protocol, therefore must be enabled with evdev data. This can be enabled -with the +protocol, therefore must be enabled with evdev data. +This can be enabled with the .Xr sysctl 8 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 -of a finger from side to side. The +of a finger from side to side. +The .Xr sysctl 8 tunable .Va hw.usb.wsp.t_factor must be greater than 0 for horizontal scrolling to be enabled, too. .Pp Horizontal swiping with a three-finger tap is registered as mouse buttons -8 and 9, depending on the direction. These buttons default to backwards -and forwards keyboard events. +8 and 9, depending on the direction. +These buttons default to backwards and forwards keyboard events. .Sh SYSCTL VARIABLES The following variables are available as .Xr sysctl 8 tunables: .Bl -tag -width indent .It Va hw.usb.wsp.scale_factor -Controls the pointer sensitivity. Default is 12. +Controls the pointer sensitivity. +Default is 12. .El .Bl -tag -width indent .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 .Bl -tag -width indent .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 .It Va max_scroll_finger_distance 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 -tapped (not clicked), respectively. Default is 8192. +tapped (not clicked), respectively. +Default is 8192. .El .Bl -tag -width indent .It Va hw.usb.wsp.max_double_tap_distance 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 .Bl -tag -width indent .It Va hw.usb.wsp.scr_threshold 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 .Bl -tag -width indent .It Va hw.usb.wsp.z_factor -Z-axis sensitivity. Default is 5. +Z-axis sensitivity. +Default is 5. .El .Bl -tag -width indent .It Va hw.usb.wsp.z_invert -Z-axis inversion. Default is 0 (disabled). +Z-axis inversion. +Default is 0 (disabled). .El .Bl -tag -width indent .It Va hw.usb.wsp.t_factor -T-axis sensitivity. Default is 0 (disabled). +T-axis sensitivity. +Default is 0 (disabled). .El .Bl -tag -width indent .It Va hw.usb.wsp.t_invert -T-axis inversion. Default is 0 (disabled). +T-axis inversion. +Default is 0 (disabled). .El .Bl -tag -width indent .It Va hw.usb.wsp.scroll_finger_count Specifies the number of tapped fingers which registers as a scrolling -movement. Default is 2. +movement. +Default is 2. .El .Bl -tag -width indent .It Va hw.usb.wsp.horizontal_swipe_finger_count Speifies the number of tapped fingers which registers as a swipe -gesture. Default is 3. +gesture. +Default is 3. .El .Bl -tag -width indent .It Va hw.usb.wsp.pressure_touch_threshold @@ -173,7 +190,9 @@ Default is 120. .It Va hw.usb.wsp.debug Specifies the .Nm -driver debugging level (0-3). Default is 1. +driver debugging level (0-3). +Default is 1. +.El .Sh FILES .Nm creates a blocking pseudo-device file, @@ -184,8 +203,7 @@ or .Em mousesystems type device--see .Xr moused 8 -for an explanation of these mouse -types. +for an explanation of these mouse types. .Sh SEE ALSO .Xr sysmouse 4 , .Xr usb 4 ,