Joystick4Doom
-------------
Are you annoyed playing Linux DOOM with your fat, clumsy fingers on your
sticky, dirty keyboard with its always wrong configured Xmodmap?

Here is the solution to all your problems: Joystick4Doom!
Grab out your good old joystick, plug in and play like never before!

All you need is your normal Linux DOOM and this little program!



Requirements
------------
You need to have the package 'joystick-0.7' (or later) for general
support of your joystick(s) under Linux. Get it, build the loadable
kernel module and insert it. Create the needed devices under /dev.
(Its all documented well in that package.)



Installation
------------
No installation. Just execute the binary you found in this archive.
It's called 'joystick4doom'.

If you really want to do something more, you can build the program
by yourself; simply type 'make'. Copy the binary to whereever you
want, maybe to somewhere in your path, maybe to /tmp or what else
you think that is a good place for it.



Parameters
----------
Start 'joystick4doom' without parameters for a brief description
of each parameter:

joystick4doom <device> <first button> <second button>

device: The device of your joystick. If you have a 'standard'
configuration from the joystick-package, it's /dev/js0 or /dev/js1.

first/second button: The keys you want to map to the two joystick
buttons. This can be anyone from { Shift, Control, Alt, Meta, Space,
Escape }, which are the keys that can be used in Linux DOOM. (The
cursor keys are automatically mapped to the four joystick directions.)

My parameter list looks like this:

./joystick4doom /dev/js0 Control Space

That lets me fire with the first button and open doors with the second one.

After the program started, it asks you to calibrate your joystick; just
follow the instructions. Then activate the window you're running DOOM in
(by moving the pointer into it) and play it!
(It doesn't make a difference if you first start DOOM or joystick4doom.)

After playing, just press Control-C to exit the program.



Bug reports, suggestions, donations, flames
-------------------------------------------
Send them all to aeglos@uni-paderborn.de!


And now have fun!

Holger Schemel
