               X J O Y S T I C K   C A L I B E R A T O R

                      INSTALLATION INSTRUCTIONS


    Basic Installation Overview:

	Step 1: Install the Linux Joystick Driver.
	Step 2: Install the Joystick Wrapper Library (libjsw).
	Step 3: Install the XJoystick Caliberator.
	Step 4: Caliberate your Joystick(s).


    1. Install the Linux Joystick Driver:

        * Skip this step if you already have it installed. *

	Download the Linux Joystick Driver 1.2.x at:

	http://atrey.karlin.mff.cuni.cz/~vojtech/joystick/

	-or-

	ftp://atrey.karlin.mff.cuni.cz/pub/linux/joystick/joystick-1.2.14.tar.gz

	Follow the instructions included in the Linux Joystick Driver.
	Rememeber to load the joystick driver modules and install the
	joystick.h header file in /usr/include/linux/joystick.h.


    2. Install the Joystick Wrapper Library (libjsw):

	Go to the `libjsw' subdirectory. Choose the most appropriate
	Makefile for your system and type `make -f <makefile>' to
	start the building process.

	If there were no errors, then type `make -f <makefile> install'
	(make sure you have root privages).


    3. Build the XJoystick Caliberator:

	Go to the `xjscal' subdirectory. Choose the most appropriate
	Makefile for your system and type `make -f <makefile>' to
	start the building process.

	If there were no errors, then type `make -f <makefile> install'
	(make sure you have root privages).


    4. Caliberating your Joystick(s):

	Make sure that you have your Linux Joystick Driver is installed
	properly and that the required modules are loaded (example,
	type `modprobe joy-analog' to load the analog joystick driver).

	Next run `xjscal' to caliberate the joystick(s) and
	create the $HOME/.joystick caliberation file. If you already
	have this file and it contains caliberations for other joysticks,
	they will be preserved and the new joystick caliberations will
	be stored in a new configuration block within the file.

	Click on the caliberation toggle button next to each axis
	readout presented in xjscal.  If you have an axis value
	that is not initially detected by xjscal, simply change
	the axis number next to the readout on xjscal to the axis
	value of the axis in question.

	Be sure to CENTER your joystick axis BEFORE clicking
	on the caliberation button again!  This is so that the
	axis center position is caliberated properly.

	If you are confused with the newer multiple axis interfaces
	or not sure which axis perform which operation, please
	consult the manual for your joystick.  Note that sometimes,
	axis numbers may not match those specified in the manual.

                                                                 ------
                                                                 XJSCal
