-----------------------------------------------------------------------

                          X S H I P W A R S

                  I N T E R N E T   E D I T I O N


                   *  INSTALLATION INSTRUCTIONS  *


-----------
Quick Start

   This section contains only a brief and terse installation
   procedure for experianced users only.   Read the 'Detailed
   installation' section below for detailed instructions.

   Edit all Makefiles as needed.


   1. `cd joytstick' then `more README'.  Do what README says.
      Make sure you lsmod the joystick driver and install the header file!

   2. `cd ../xjscal' then `make clean;make all'.

   3. `./xjscal' then caliberate your joystick(s).  The file .joystick
      will be created in your home directory when you save then exit.

   4. `cd ../client' then `make clean;make all'.

   5. Make a directory `/usr/games/xshipwars', then
      `cp -R images /usr/games/xshipwars'

   6. Make a directory `/usr/games/xshipwars/etc', then
      `cp .xshipwarsrc /usr/games/xshipwars/etc/xshipwarsrc'

   7. Run `./xsw swserv://aq.xshipwars.com:1701 &' or whatever site you
      want to connect to, then press F9 to connect.  Read docs/xsw.doc
      for complete usage on the client!


   For additional and server installation instructions, read below.



---------------------
Detailed Installation


   1. Linux Joystick Driver:

      If you do *not* have a joystick driver for Linux, then build the
      joystick driver acompanied in this distribution first.

      cd to the 'joystick' subdirectory and read the README in that
      directory. Follow its direction for installing the joystick.

      Please keep in mind that the Linux joystick driver is 3rd party
      software. Support may be obtained by contacting the authors
      mentioned in the README file in the joystick subdirectory.

      Don't forget to lsmod the joystick driver and install the
      joystick.h header file in /usr/include/linux/joystick.h.


   2. XJoystick Caliberator:

      If you do *not* have a joystick caliberation program, then
      build the joystick caliberation program.  Change directory to
      the 'xjscal' directory.   Edit the Makefile as needed and type
      'make clean;make all'.

      Copy the `xjscal' binary executable to your global X windows binary
      directory, which is usually /usr/X11/bin.


   3. XShipWars Client:

      Change directory to the 'client' directory. Edit the Makefile as
      needed and type 'make clean;make all'.

      Next, create the directory:

          /usr/games/xshipwars

      Copy all the images to /usr/games/xshipwars/images, type:

          cp -R images /usr/games/shipwars

      Copy the .xshipwarsrc file to the global shipwars etc directory:

	  cp .xshipwarsrc /usr/games/xshipwars/etc/xshipwarsrc

      Make another copy to your home dir:

          cp .xshipwarsrc $HOME

      Copy the `xsw' binary executable to your global X windows binary
      directory, which is usually /usr/X11/bin.

      Read docs/xsw.doc for information on using the XShipWars client.



   4. ShipWars Server:

      Change directory to the 'server' directory. Edit the Makefile
      as needed and type 'make clean;make all'.

      Next, create the directory:

	/home/swserv

      ( Or whereever you want the toplevel directory for SWServ to
      be. )

      Create the additional sub directories above the SWServ toplevel
      directory:

	/home/swserv/bin
        /home/swserv/etc
        /home/swserv/logs
        /home/swserv/db

      Copy the `swserv' binary executeable and `restart' script to:

	cp swserv /home/swserv/bin
	cp restart /home/swserv/bin

      (You may want to edit the restart script as needed.)

      Copy the database file to:

	cp generic_in.db /home/swserv/db

      Copy the default configuration `swserv.conf' file to:

	cp swserv.conf /home/swserv/etc



-----------------------------------------------------------------------            
                                                              XShipWars
