home *** CD-ROM | disk | FTP | other *** search
/ vsiftp.vmssoftware.com / VSIPUBLIC@vsiftp.vmssoftware.com.tar / FREEWARE / FREEWARE40.ZIP / xsokoban-31 / readme < prev    next >
Text File  |  1994-03-05  |  3KB  |  73 lines
  1. XSokoban 3.1
  2. ------------
  3.  
  4. This is the third release of XSokoban.
  5.  
  6. This distribution contains all the files to compile and run the game,
  7. the original 50 sokoban screen files, 40 additional screen files
  8. gleaned from various public domain versions of sokoban, and a manual
  9. page that explains how the game works.
  10.  
  11. Installation -
  12.   - Edit the header files config.h and config_local.h to define the
  13.     appropriate paths and compilation options for your system.
  14.     These defines should be checked carefully to make sure they are
  15.     correct.
  16.  
  17.   - Use 'xmkmf' to produce a Makefile from the Imakefile provided, or
  18.     else edit 'Makefile' to set the compiler and compiler flags correctly
  19.     and select the right libraries to compile with.
  20.  
  21.       - If you want to have the game run in color, you will need the
  22.     XPM library. In this case, make sure that in the previous step, the
  23.     option EXTRA_INCLUDES points to the directory containing
  24.     "xpm.h", and that EXTRA_LIBRARIES references the directory
  25.     containing the library "libXpm.a". Last time I checked, XPM
  26.     could be obtained by FTP from export.lcs.mit.edu:contrib. Make
  27.     sure your version of XPM is up to date. The current pixmaps
  28.     definitely work with versions 3.2g and 3.3, but not with version 2.
  29.  
  30.   - Compile by typing 'make'.  If something goes wrong, and you can track
  31.     down an error, send me a bug report (including what changes you needed
  32.     to make, and I will see about fixing it for later distributions).
  33.  
  34.   - Play the game by typing 'xsokoban'. If it complains about not being
  35.     able to read the scorefile, create one with 'xsokoban -c'. If this
  36.     doesn't work, it is probably because you need to create the score
  37.     directory. See config.h.
  38.  
  39.   - Set ROOTDIR to the desired final location for the xsokoban data files,
  40.     and rebuild.  Install the game by typing 'make install' or by
  41.     manually copying the executable. Install the directories screens/,
  42.     scores/, bitmaps/, and saves/ under ROOTDIR.
  43.  
  44. Notes -
  45.  
  46.   - The screen files need to be publically readable and should not be
  47.     writable.
  48.  
  49.   - The score file should be readable/writeable ONLY by the 'superuser' of the
  50.     program (see config.h for what 'superuser' means).
  51.  
  52.   - The save files should be readable/writeable ONLY by the 'superuser'.
  53.  
  54.   - Because of this, the game needs to be run setuid of the person who is
  55.     'superuser'.
  56.  
  57. Credits -
  58.  
  59.     Unknown Hacker - Original curses(1) implementation.
  60.     Joseph L. Traub - X windows interface.
  61.     Kevin Solie - simultaneously developed X implementation (merged in).
  62.     Mark Linderman, Christos Zoulas - Mouse code (added to Solie's version).
  63.     Andrew Myers - Improved mouse UI, score ranking and color support
  64.  
  65. Fixes/Bug Reports/Modifications -
  66.  
  67.     If you make any changes to this program, fix any bugs, add any neat
  68.     features, or whatever, please send mail to "andru@lcs.mit.edu"
  69.     so that I can add them in to the newest release.
  70.  
  71. --Andrew Myers
  72.   (andru@lcs.mit.edu)
  73.