xpacman.README

XPacman version 0.11
--------------------
(c) Peter Warden 14th August 1996

This is a basic version of pacman. I've tried to concentrate on the essentials
of the game for now, which means a lot of the original features are absent (ie
no scores, no fruit, no special items, no lives). When all the pills have been 
cleared from a level, the difficulty level is notched up, and a new level is
generated. If you collide with a ghost, all the pills are replaced, and you
restart the current level from scratch. A new feature just added is the
presence of large red pills that for a short time turn the ghosts grey and let
you eat them.

The default keys are: 'a'-left
                      's'-right
                      'z'-down
                      'w'-up
                      'q'-quits you from the game.

The game is paused when it loses the keyboard input focus and unpauses when it
regains it.

Command line options:

  -upkey -downkey -leftkey & -rightkey followed by a character allow you to set
   which keys make you move in which directions.

  -quitkey followed by a character sets the quit key.

  -framerate followed by a number sets the maximum number of frames that will
   be displayed per second, so altering the games speed (default is 15).

  -level followed by a number sets the difficulty level (default is 0).

  -width & -height followed by a number specify the width and height of the 
   playing area, in 16 pixel units (default is 33x33).


Installation:

  Gunzip and untar the xpacman.tar.gz file.
  Run "xmkmf" inside the resulting directory to generate the correct makefile 
  for your system.
  If "xmkmf" succeeds, running "make" will generate the xpacman executable.
  If you have any problems with xmkmf or imake, run "make -f Makefile.noimake".
  If compilation fails due to problems with gettimeofday(), mail me for an
  older version of xpacman which uses software timing.

My thanks go to Danny Backx, Garland Stern, Larry Schwimmer, Oeyvind Roetvold
and everybody else who's given their time and expertise to help me improve this
project.

Absolutely no warranty is given for this program.

If you have any problems with xpacman, find any bugs, have a suggestion, or just
enjoyed the game, email me and let me know.

Peter Warden (wardenp@cs.man.ac.uk)