Xpsitouch is a minimal mouse button and LCD toolbar handler.

Requirements: Psion, Linux, X11

Xpsitouch tries to do three things with minimal memory usage:

1. Xpsitouch allows you to change the mouse pointer button with
   keyboard. The default action is following:

   KEY COMBINATION		MOUSE POINTER ACTION

   Shift+Left Arrow		Change to Pointer 1 immediately

   Shift+Down Arrow		Change to Pointer 2 immediately
   				and change back to Pointer 1 after
				a 1.5 second delay

   Shift+Right Arrow		Change to Pointer 3 immediately
   				and change back to Pointer 1 after
				a 1.5 second delay

2. Xpsitouch allows you to change the mouse pointer button with the
   pen using the left toolbar. The toolbars are the rows of buttons 
   on the left and at the bottom of the LCD on Psions.

   TOOLBAR BUTTON		MOUSE POINTER ACTION

   Magnifier +			Change to Pointer 1 immediately

   The area between		Change to Pointer 2 immediately
   Magnifier + and 		and change back to Pointer 1 after
   Magnifier -			a 1.5 second delay

   Magnifier -			Change to Pointer 3 immediately
   				and change back to Pointer 1 after
				a 1.5 second delay

3. Xpsitouch allows you to launch programs from the toolbar buttons.

   Any time a button is pressed with the pen, a shell script is called
   with the toolbar and button number. The shell script that gets 
   called is /etc/xpsitouchrc.sh. To modify the toolbar commands, 
   just modify this shell script, or copy it to ~/.xpsitouchrc.sh.


KNOWN BUGS

- Currently no other command line options except -display or -d
- No way to change keyboard mapping without recompiling; I'll 
  add these as command line options.
- The red System button on the toolbar seems to be ignored easily;
  this could be a problem on my Psion only?

INSTALLATION

Untar the file, and copy the armlinux compiled xpsitouch binary to
/usr/X11R6/bin/ directory. Then copy the xpsitouchrc.sh to /etc/ 
directory. Start X, and run xpsitouch.

Comments and improvments welcomed! Send comments to the psilinux.org
mailing list, or to tony@atomide.com
