Commit 1583ee5a9fd9486d540ecf639dda53d5e2e7502e

Peter Hutterer <peter.hutterer @wh…t.net>
Fri Jan 01 03:13:44 CET 2010

Tree SHA1: 0079a90
Parent SHA1: 27addb0 (Rename xf86Wcm* to wcm* - part 2)
raw diff | raw patch

Update README to reflect current state a bit better.

This driver is an X11 driver only, and the configure options are explained
by configure --help. Let's not mirror this in the README, it may diverge
otherwise.

Add a very simple explanation on how to set up the driver fro hotplugging
with HAL, xorg.conf configuration is better explained in the man page.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Diff rendering mode:
inline
side by side


1		README
2		April 23, 2009
	1	This package provides the X.Org X11 driver for Wacom and Wacom-like tablets.
	2	It obsoletes the linuxwacom driver and supports X server versions 1.7 and
	3	higher. Server versions lower than 1.7 may be supported by this driver, but
	4	users are encouraged to use the old linuxwacom driver instead.
3	5
4		==============================================================================
5		Most end users would probably only need to update the /etc/X11/xorg.conf file
6		and sometime probably the Wacom X driver as well to use the rich features that
7		Wacom tablets offer. The steps could be as simple as:
	6	Provided that hotplugging is enabled in the X server, the simplest
	7	configuration is to copy the wacom.fdi file into /etc/hal/fdi/policies and
	8	to restart HAL and then plug in the tablet. The driver will autoconfigure
	9	itself.
8	10
9		$ su
10		# cp /etc/X11/xorg.conf /etc/X11/xorg.conf.bak
11		# gedit /etc/X11/xorg.conf
	11	If hotplugging is not possible or desired, an InputDevice section in the
	12	xorg.conf with the Driver wacom will load the device. Details on the
	13	configuration can be found in xorg.conf(5) and wacom(4).
12	14
13		then follow the step listed at http://linuxwacom.sourceforge.net/index.php/howto/x11
14		or "man wacom" if you don't have network access to add sections for Wacom device.
	15	Since this driver is an X11 driver only, a kernel driver is required to get
	16	hardware support. If the kernel driver is older than this driver, some
	17	features may not be available.
15	18
16		If by some reason your distribution doesn't have include Wacom driver or you want to
17		to use the newer release, you can download the package then
18
19		$ bunzip2 linuxwacom.tar.bz2
20		$ tar xvf linuxwacom.tar
21		$ cd linuxwacom/prebuilt
22		$ su
23		# yum remove linuxwacom
24		# ./uninstall
25		# ./install
26		# reboot
27
28	19	==============================================================================
29	20
30		However, if you have a USB tablet which is newer than your running kernel, i.e.,
31		the tablet is not supported by your running kernel, or you are a developer who is
32		willing to build the driver from the source, there are extra work waiting for you.
	21	BUILDING FROM GIT:
	22	$ ./autogen.sh --prefix=/usr
	23	Adjust the prefix according to your local setup, in most cases, a prefix of
	24	/usr is correct.
33	25
34		==============================================================================
35
36	26	BUILDING FROM TARBALL:
37	27
38		As you would expect, run configure and make. Configure options are explained below.
39
40	28	$ ./configure && make
	29	Adjust the prefix according to your local setup, in most cases, a prefix of
	30	/usr is correct.
41	31
42	32	==============================================================================
43
44		CONFIGURE OPTIONS:
45
46		This file contains hints for building the sources. There are a number of build
47		targets, some of which are not built automatically. Here is the
48		breakdown:
49
50		wacom.o: not built by default (--enable-wacom, --disable-wacom)
51		wacdump: built by default (--enable-wacdump, --disable-wacdump)
52		xidump: built by default (--enable-xidump, --disable-xidump)
53		xsetwacom: built by default (--enable-xsetwacom, --disable-xsetwacom)
54		hid.o: not built by default (--enable-hid, --disable-hid; Only kernels 2.6.18 or older need it.)
55		wacom_drv.o: built by default (--enable-wacomdrv, --disable-wacomdrv)
56
57		There are many options, and configure will attempt to guess the correct
58		values for most of them. By default, only wacomcpl, xsetwacom, wacom_drv.o,
59		xidump, and wacdump program are built.
60	33
61	34	Please surf the HOWTO page at http://linuxwacom.sf.net/index.php/howto/main
62	35	(or the miniHOWTO at http://linuxwacom.sourceforge.net/index.php/minihowto if

Commit 1583ee5a9fd9486d540ecf639dda53d5e2e7502e

Gitorious