[src/trunk]: src synaptics: Set up_down_emulation=3 by default.

[nia <nia%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/8665224cd3be
branches:  trunk
changeset: 1008202:8665224cd3be
user:      nia <nia%NetBSD.org@localhost>
date:      Sat Mar 14 19:29:39 2020 +0000

description:
synaptics: Set up_down_emulation=3 by default.

It's a less surprising default for modern hardware.

diffstat:

 share/man/man4/pms.4         |  18 ++++++++++--------
 sys/dev/pckbport/synaptics.c |   6 +++---
 2 files changed, 13 insertions(+), 11 deletions(-)

diffs (73 lines):

diff -r a0c52ecf3e49 -r 8665224cd3be share/man/man4/pms.4
--- a/share/man/man4/pms.4      Sat Mar 14 19:07:22 2020 +0000
+++ b/share/man/man4/pms.4      Sat Mar 14 19:29:39 2020 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pms.4,v 1.35 2020/03/14 13:08:18 nia Exp $
+.\" $NetBSD: pms.4,v 1.36 2020/03/14 19:29:39 nia Exp $
 .\"
 .\" Copyright (c) 1993 Christopher G. Demetriou
 .\" All rights reserved.
@@ -32,7 +32,7 @@
 .\"
 .\" <<Id: LICENSE,v 1.2 2000/06/14 15:57:33 cgd Exp>>
 .\"
-.Dd February 11, 2020
+.Dd March 14, 2020
 .Dt PMS 4
 .Os
 .Sh NAME
@@ -102,19 +102,21 @@
 variables control behavior of Synaptics touchpads:
 .Bl -tag -width 8n
 .It Dv hw.synaptics.up_down_emulation
-If the touchpad reports the existence of Up/Down buttons, this value
-determines if they should be reported as button 4 and 5 events or if
-they should be used to emulate some other event.
+If the touchpad reports the existence of extra ("Up/Down") buttons, this
+value determines what kind of mouse events they should generate.
+On certain clickpads, the Up/Down buttons may be physical buttons that
+can be used instead of pressing the pad down, or used as additional
+buttons.
 .Bl -bullet
 .It
 If set to 0, Up/Down events generate button 4 and 5 clicks.
 .It
 If set to 1, Up/Down events generate middle button clicks.
 .It
-If set to 2 (default), the Up and Down buttons are used for Z-axis
-emulation, which more closely resembles how mouse wheels operate.
+If set to 2, the Up and Down buttons are used for Z-axis emulation,
+which more closely resembles how mouse wheels operate.
 .It
-If set to 3, Up/Down events generate left/right clicks.
+If set to 3 (default), Up/Down events generate left/right clicks.
 .El
 .It Dv hw.synaptics.up_down_motion_delta
 When the Up/Down buttons are used for Z-axis emulation, this value specifies
diff -r a0c52ecf3e49 -r 8665224cd3be sys/dev/pckbport/synaptics.c
--- a/sys/dev/pckbport/synaptics.c      Sat Mar 14 19:07:22 2020 +0000
+++ b/sys/dev/pckbport/synaptics.c      Sat Mar 14 19:29:39 2020 +0000
@@ -1,4 +1,4 @@
-/*     $NetBSD: synaptics.c,v 1.55 2020/03/14 13:08:18 nia Exp $       */
+/*     $NetBSD: synaptics.c,v 1.56 2020/03/14 19:29:39 nia Exp $       */
 
 /*
  * Copyright (c) 2005, Steve C. Woodford
@@ -48,7 +48,7 @@
 #include "opt_pms.h"
 
 #include <sys/cdefs.h>
-__KERNEL_RCSID(0, "$NetBSD: synaptics.c,v 1.55 2020/03/14 13:08:18 nia Exp $");
+__KERNEL_RCSID(0, "$NetBSD: synaptics.c,v 1.56 2020/03/14 19:29:39 nia Exp $");
 
 #include <sys/param.h>
 #include <sys/systm.h>
@@ -98,7 +98,7 @@
 static int pms_sysctl_synaptics_verify(SYSCTLFN_ARGS);
 
 /* Controlled by sysctl. */
-static int synaptics_up_down_emul = 2;
+static int synaptics_up_down_emul = 3;
 static int synaptics_up_down_motion_delta = 1;
 static int synaptics_gesture_move = 200;
 static int synaptics_gesture_length = 20;