mammadori / qjoypad Goto Github PK

Chapter 2. Getting Started

2.1. Requirements

     - A Linux computer and a Linux-compatible gaming device
     - A Linux kernel with joystick support (see the Linux Kernel
       HOWTO  [http://www.linuxdocs.org/HOWTOs/Kernel-HOWTO.html]
       and the Linux joystick driver website
       http://atrey.karlin.mff.cuni.cz/~vojtech/joystick/)
     - XWindows (see www.xfree86.org)
     - Trolltech's QT (see www.trolltech.com)
     _________________________________________________________

2.2. Installation

   Installing QJoyPad should be a quick and painless process. The
   basic procedure is:

   ./config
   make
   make install

   however,  there  are  some  settings  that  might  need  to be
   changed.

    1. Device  directory:  By  default,  QJoyPad  will  look  for
       joystick  devices  in  /dev/input, but if your system puts
       them  somewhere else, you'll need to run ./config with the
       argument  --devdir=DIR,  where  DIR is where your joystick
       devices reside. For instance, if your joystick devices are
       /dev/js0, /dev/js1, etc., instead of running ./config, run
       ./config --devdir="/dev"
    2. Install  directory:  By default, QJoyPad will try to put a
       copy   of   itself   in   /usr/local/bin,  some  icons  in
       /usr/local/share/pixmaps,     and     this    readme    in
       /usr/local/doc/qjoypad3 so that they will be accessible to
       all  users.  If you want these files to go somewhere other
       than  /usr/local (or if you don't have permission to write
       to   /usr/local),   you'll   need  to  pass  the  argument
       --prefix=DIR  to  ./config.  For example, if you wanted to
       install  QJoyPad just for yourself in your home directory,
       you  could  run  ./config --prefix="/home/user" instead of
       ./config.
    3. Use  Plain  Keys:  Normally,  QJoyPad doesn't use standard
       XWindows  key names to describe your keyboard, but instead
       uses  names  that  look nicer and are easier to recognize.
       For   instance,   instead   of  "KP_Begin",  "Prior",  and
       "Shift_L", QJoyPad uses "KP 5", "PageDown", and "L Shift".
       If  you  think  generating  these  names  is  a  waste  of
       processor  power, or if you don't think you're getting the
       right  name for the key you're pressing, pass the argument
       --plain_keys  to  ./config  and  QJoyPad will just use the
       XWindows default names.

   Of course, you can mix use as many of these options at once as
   you    like.    For    instance    ./config    --devdir="/dev"
   --prefix="/home/user" is completely valid.