ports/148591: information note for x11-drivers/xf86-input-synaptics

[David DEMELIER]

>Number:         148591
>Category:       ports
>Synopsis:       information note for x11-drivers/xf86-input-synaptics
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-ports-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Wed Jul 14 09:30:06 UTC 2010
>Closed-Date:
>Last-Modified:
>Originator:     David DEMELIER
>Release:        8.1-RC2
>Organization:
>Environment:
FreeBSD Melon.malikania.fr 8.1-RC2 FreeBSD 8.1-RC2 #2: Wed Jul 14 10:39:49 CEST 2010     root at Melon.malikania.fr:/usr/obj/usr/src/sys/Melon  amd64

>Description:
When using x11-drivers/xf86-input-synaptics under FreeBSD, the user must modify some files to make it works. And a such beginner user shouldn't be able to do it easily.

1° If the user do not set `Option      "Protocol" "psm"' in the xorg.conf, the driver won't work.

2° The user need to add `hw.psm.synaptics_support="1"' to the loader.conf to make it works too.

And xf86-input-synaptics does not tell anything about it, I wrote a short summary about these settings in a pkg-message.

Please tell me if you agree.
>How-To-Repeat:

>Fix:
--- Makefile.orig	2010-07-14 11:22:25.000000000 +0200
+++ Makefile	2010-07-14 11:22:45.000000000 +0200
@@ -23,6 +23,7 @@
 MAN4=		synaptics.4x
 
 post-install:
+	${CAT} ${PKGMESSAGE}
 	${MKDIR} ${PREFIX}/share/hal/fdi/policy/10osvendor
 	${INSTALL_DATA} ${WRKSRC}/fdi/11-x11-synaptics.fdi \
 		${PREFIX}/share/hal/fdi/policy/10osvendor/
--- /dev/null	2010-07-14 11:22:00.000000000 +0200
+++ pkg-message	2010-07-14 11:20:35.000000000 +0200
@@ -0,0 +1,22 @@
+To enable synaptics in the psm(4) driver you need to add the following into the
+/boot/loader.conf :
+
+	hw.psm.synaptics_support="1"
+
+You also need the following into your xorg.conf :
+
+	Section "InputDevice"
+		Identifier  "Touchpad0"
+		Driver      "synaptics"
+		Option      "Protocol" "psm"
+		Option      "Device" "/dev/psm0"
+	EndSection
+
+And be sure to add the following into the `ServerLayout' section :
+
+	InputDevice    "Touchpad0" "SendCoreEvents"
+
+To make xf86-input-synaptics works, you also need to disable moused(8), so add
+the following in your rc.conf(5) :
+
+	moused_nondefault_enable="YES"


>Release-Note:
>Audit-Trail:
>Unformatted: