File	Date	Author	Commit
docs	2005-12-23	pingc	[256855] Update web pages
src	2006-09-27	pingc	[cb26a3] Release 0.7.5-4
AUTHORS	2005-09-07	pingc	[8e5b9d] Updated wacdump and acinclude.m4
ChangeLog	2006-09-27	pingc	[cb26a3] Release 0.7.5-4
GPL	2002-12-23	jjoganic	[cf0227] Initial revision
LGPL	2002-12-23	jjoganic	[cf0227] Initial revision
Makefile.am	2003-06-17	jjoganic	[4a5d4f] Added mkxincludes, automatic configure for x-in...
NEWS	2006-05-03	pingc	[ce77d1] Removed older 2.6 kernels
README	2005-12-04	pingc	[d5d4c3] updated configure.in
acinclude.m4	2006-09-27	pingc	[cb26a3] Release 0.7.5-4
bootstrap	2003-05-03	jjoganic	[58bb5f] Added xsetwacom and friends; configuration comi...
configure.in	2006-09-27	pingc	[cb26a3] Release 0.7.5-4
mkxincludes.in	2003-06-17	jjoganic	[d6aa93] Added xf86 version.

Read Me

README
Dec. 05, 2005

==============================================================================

BUILDING FROM CVS:

You should run bootstrap from the main directory to correctly initialize
the project.  From there, run configure as you would normally do.  Configure 
options are explained below.

    $ ./bootstrap && ./configure && make

==============================================================================

BUILDING FROM TARBALL:

As you would expect, run configure and make.  Configure options are explained below.

    $ ./configure && make

==============================================================================

CONFIGURE OPTIONS:

This file contains hints for building the sources.  There are a number of
build targets, some of which are not built automatically.  Here is the
breakdown:

      wacom.o: not built by default (--enable-wacom, --disable-wacom)
      wacdump: built by default (--enable-wacdump, --disable-wacdump)
        hid.o: not built by default (--enable-hid, --disable-hid)
      evdev.o: not built by default (--enable-evdev, --disable-evdev)
   mousedev.o: not built by default (--enable-mousedev, --disable-mousedev for kernel 2.4.x only)
   usbmouse.o: not built by default (--enable-usbmouse, --disable-usbmouse for kernel 2.4.x only)
      input.o: not built by default (--enable-input, --disable-input for kernel 2.4.x only)
  wacom_drv.o: built by default (--enable-wacomdrv, --disable-wacomdrv)

There are many options, and configure will attempt to guess the correct
values for most of them.  By default, only wacomcpl, xsetwacom, wacom_drv.o, 
xidump, and wacdump program are built.

REQUIREMENTS:

wacom, hid, evdev, mousedev, and usbmouse are kernel modules and require the 
kernel sources to be present.  On a Redhat 8.0 system with the kernel-sources
RPM installed, the source directory is located at /usr/src/linux-2.4.
The configuration script will search for this directory automatically as 
well as /usr/src/linux.  You can override the directory using the 
--with-kernel=<directory> option.

For kernel 2.6.x, a kernel source with which your tablet is going to run should 
be precompiled before configuring linuxwacom package. For the steps to build a 
kernel from source, please refer to your source's README or www.kernel.org. For 
kernels newer than 2.6.4 (and you are not using Intuos3), wacom.c and hid-core.c 
are up to date, that is, you probably don't need to build the kernel. But, if you 
want to use the "hotplug" feature of the tablet, you need to build evdev from this 
package.

wacom_drv.o requires XFree86 sources as well as a functional XF86 build  
environment or xorg-sdk if your X server is from x.org.  Since this is a more 
complicated setup and few people are going to want to rebuild this driver from  
source, the wacom_drv.o files are supplied with the linuxwacom package in the 
prebuilt directory.  If the prebuilt wacom_drv.o module doesn't work for you, 
see the section "Building wacom_drv.o From Scratch."
	
BUILDING wacom_drv.o FROM SCRATCH

If your system runs an X server from XFree86, you need the XFree86 
source code, and you will need to actually build it.  The file 
xf86Version.h is generated during the build process and is a required 
dependency for building wacom_drv.o.  If your system runs an X server 
from x.org, you need to install xorg-sdk. The configure script will 
attempt to build wacom-drv.o by default,  but you need to provide the 
--with-xf86=<xf86_directory> option.  If you don't want to build wacom-drv.o, 
the option --disable-wacomdrv needs to be provided.

If the xf86Version.h file is located at:
	/usr/local/src/XFree86-4.2.0/xc/programs/Xserver/include/xf86Version.h

Then the correct configure option to build wacom_drv.o would be:
	--with-xf86=/usr/local/src/XFree86-4.2.0

INSTALL default

Generally, you run the configure script followed by make install.  This package 
will install wacom_drv.o, xidump, wacdump, xsetwacom, and wacomcpl. The kernel 
drivers will not be installed.  Please see the documentation on the website for 
more information on where specific drivers belong.

    [jej@haku linuxwacom-dev] $ ./configure
    [jej@haku linuxwacom-dev] $ su
    [root@haku linuxwacom-dev] # make install 

INSTALL wacomcpl

wacomcpl is a tcl/tk based control panel. It requires tcl/tk being installed. 
The configure script will attempt to build wacomxi libs by searching /usr/include,
/usr/tcl/include, and /usr/tcl$version/include for tcl/tk headers and /usr/lib
for tcl/tk libs. You can override the directories using the --with-tcl=<directory> 
and --with-tk=<directory> options.

On Fedora Core 3, the steps to install tcl/tk development is as following:

    [jej@haku linuxwacom-dev] $ su
    [root@haku linuxwacom-dev] # yum install tcl
    [root@haku linuxwacom-dev] # yum install tcl-devel
    [root@haku linuxwacom-dev] # yum install tk
    [root@haku linuxwacom-dev] # yum install tk-devel

configure script will find the path for you, i.e., you don't need to specify option --with-tcl 
and --with-tc in the configure command.

However, if the tcl.h is located at specific directory other than /usr or /usr/tcl, say it is at /usr/local/tcl8.4/include and the libtcl8.4.so at /usr/local/tcl8.4/lib, you need to:

First link /usr/local/tcl8.4/lib/libtcl8.4.so to /usr/lib/libtcl.so.0:
	ln -s /usr/local/tcl8.4/lib/libtcl8.4.so /usr/lib/libtcl.so.0

Then use the configure option:
	--with-tcl=/usr/local/tcl8.4

If the tk.h is located at /usr/local/tk8.4/include and the libtk8.4.so at 
/usr/local/tk8.4/lib, then the correct steps would be:
	ln -s /usr/local/tk8.4/lib/libtk8.4.so /usr/lib/libtk.so.0

Then use the configure option:
	--with-tk=/usr/local/tk8.4

If both tcl and tk under the same directory, say /usr/local/tcl8.4, then the steps are:
	ln -s /usr/local/tcl8.4/lib/libtcl8.4.so /usr/lib/libtcl.so.0
	ln -s /usr/local/tcl8.4/lib/libtk8.4.so /usr/lib/libtk.so.0

And use the configure option:
	--with-tcl=/usr/local/tcl8.4


INSTALL kernel pieces

for kernel 2.4.22 or newer: 
    [root@haku linuxwacom-dev] # cp src/2.4.22/hid.o /lib/modules/your_kernel_version/kernel/drivers/usb 
    [root@haku linuxwacom-dev] # cp src/2.4.22/usbmouse.o /lib/modules/your_kernel_version/kernel/drivers/usb
    [root@haku linuxwacom-dev] # cp src/2.4.22/wacom.o /lib/modules/your_kernel_version/kernel/drivers/usb 
    [root@haku linuxwacom-dev] # cp src/2.4.22/mousedev.o /lib/modules/your_kernel_version/kernel/drivers/input 
    [root@haku linuxwacom-dev] # cp src/2.4.22/evdev.o /lib/modules/your_kernel_version/kernel/drivers/input
    [root@haku linuxwacom-dev] # cp src/2.4.22/input.o /lib/modules/your_kernel_version/kernel/drivers/input 

for kernels older than 2.4.22: 
    [root@haku linuxwacom-dev] # cp src/2.4/hid.o /lib/modules/your_kernel_version/kernel/drivers/usb 
    [root@haku linuxwacom-dev] # cp src/2.4/usbmouse.o /lib/modules/your_kernel_version/kernel/drivers/usb
    [root@haku linuxwacom-dev] # cp src/2.4/wacom.o /lib/modules/your_kernel_version/kernel/drivers/usb 
    [root@haku linuxwacom-dev] # cp src/2.4/mousedev.o /lib/modules/your_kernel_version/kernel/drivers/input 
    [root@haku linuxwacom-dev] # cp src/2.4/evdev.o /lib/modules/your_kernel_version/kernel/drivers/input
    [root@haku linuxwacom-dev] # cp src/2.4/input.o /lib/modules/your_kernel_version/kernel/drivers/input 

for kernel 2.6.x
    [root@haku linuxwacom-dev] # cp src/2.6.x/hid.ko /lib/modules/your_kernel_version/kernel/drivers/usb/input 
    [root@haku linuxwacom-dev] # cp src/2.6.x/wacom.ko /lib/modules/your_kernel_version/kernel/drivers/usb/input 
    [root@haku linuxwacom-dev] # cp src/2.6.x/evdev.ko /lib/modules/your_kernel_version/kernel/drivers/input 

==============================================================================

WEBSITE: http://linuxwacom.sf.net