New for version 0.0.1:

The code portable to hpux and solaris (I hope).  Special thanks to Bill Broadley
for solaris fixes and Bert Gijsbers for the HP-UX fixes.
Documeted the u,y,b and v keys that control the speed of the simulation.

Changed planets back to asteriods.
Various bug fixes.

Space wars is a multi player game that simulates space ships fighting each
other.  You must have X11 installed on your system in order for it to work.
It has been tested on 
 SunOS Release 4.1.1
 ULTRIX V4.3A
 I am told it also works on the DEC alpha.

Space wars should work on any Unix platform. It may even work on non unix that
has X11 installed.  Please send me mail if you get it to work on any other
machines.

Please report any bugs, comments or ideas to rnaugle@isd.csc.com.

Version 0.0 consists of implemenation of the long range viewer
on multiple displays.  This includes allowing several users to control their 
ship  via keyboard and mouse input.  The user is presented with a window that 
show his ship and other objects that are in range of the viewer.  The status of
the user's ships systems are displayed in another window.




Under the  directory that you tared there are four subdirectories:

     bin    :  Contains all of the files needed to execute the simulation
     test1  :  Contains configuration files that starts the simulation.

     test2  :  Contains configuration files that starts the simulation with  
               different data files.
     source :  Contains all of the source code files needed to build the
               executable

The test1 and test directories will demonstrate how changing the data files
for the simulation can change the different attributes of the simulation and
ships.

To run the simulation cd to either the test1 or test2 directories and type go.
Two windows should appear on your display. These windows represent player
one and player two.  Putting two players on the same display slows the simulation
down considerably.  If you want to put player two on another display then 
type go [displayname] where display name is name of the display where you
want the second players screen to be on.  For example if you type
  go vienna15:0.0 
Your display will only get one window and the second player's window will be
displayed on vienna15:0.0


The following keys control your ship (Green)  
 esc : exit program.
 4 : rotate counter clockwise
 5 : turn on thrusters to move ship in the direction the ship is facing
 6 : rotate clockwise
 space bar : fire weapons
 0 : toggle shields on / off
 . : turn on cloak
 + : Hyperspace (Move ship to a random location on the screen
 a : Add asteriod objects so you can have something to shoot at.
 h : Halt. Stop the ship.
 r : Redraw screen.
 s : create a new ship.  You need to do this after your ship gets destroyed.
 - : Fire multiple bullets in an arc.
 / : Self destruct your ship
 m : zoom in
 n : zoom out
 l : locker scanners on nearest ship

Keys to control the speed of the simulation:
 u : increase speedscale
 y : decrease speedscale
 b : increase moves/update
 v : decrease moves/update

Mouse buttons :
  Left : rotate counter clockwise.  If your ship has a turret then this button will
         fire your weapon in the direction mouse cursor.
  Middle : turn on thrusters to move ship in the direction the ship is facing
  Right : rotate clockwise


The window can be resized by using the window manager's shell.
Large windows will run slower due to the time it takes to redraw the screen.

This code uses the asteriods code by Phil Goetz as template for the
definition of the objects displayed in the simualtion.  I have added the 
the following enhancements and features to the code:

  Ascii files define most of the simulation parameters like the size of
  the playfield, shape of a ship, and the attributes for the ship's systems.
  Color display
  Ship systems
  Damage and repair of ship systems
  Mouse control of the ship
  Multiple display support 
  Scrolling display.
  Optimization and redesign of code.
  Multiple bullet fire, self destruct.
  Ship Status window
  Scanned Ship Status window
  Long Range Scan window.

The white ship is a computer controlled ship that has a very simple program:
Always face the enemy and shoot. About every 5 seconds choose a random x and
y velocity.  This program always shoot at the enemy's current location.
It will always hit you if you stay still (h key) and its weapons are in range.


The bars in the ship status windows change colors based on the status of each
system:
     Green          - system is 100% repaired
     Yellow         - system is damaged
     Red            - system is very damaged and is not operational.
                      The system can be repaired.
     Black (No Bar) - System is destroyed.  The system cannot be repaired.


Robert Naugle  rnaugle@isd.csc.com