1XSokoban 3.3c
2-------------
3
4This distribution
5contains all the files to compile and run the game,
6the original 50 sokoban screen files, 40 additional screen files
7gleaned from various public domain versions of sokoban, and a manual
8page that explains how the game works.
9
10
11 Installation
12 Credits
13 Fixes, Bug Reports, and Modifications
14 Redistribution
15 Play Safely!
16 NO WARRANTY!
17
18
19Installation
20
21
22 Edit the header file config.h to define the
23 appropriate paths and options for your system. These defines
24 should be checked carefully to make sure they are correct.
25
26
27
28 You can compile xsokoban in either WWW mode or local mode.
29 Where it stores scores depends on the mode. The mode is
30 controlled by the WWW option; see "config.h" for
31 more details.
32
33
34 If compiling in WWW mode, make sure you change the variable
35 HERE to refer to your location!
36
37
38Do one of the following (A,B, or C) to produce a Makefile:
39
40
41 A. (Easy) Run the script "configure" to produce the include file
42 "config_local.h" and a Makefile. By default, the gnu C compiler
43 is used to build; if you want to use "cc", do
44
45 configure --with-CC=cc
46
47 instead.
48
49
50 B. OR: Edit "config_local.h" by hand, and use "xmkmf" to
51 produce a Makefile from the Imakefile provided.
52
53
54 C. OR: Edit "config_local.h" and "Makefile" by hand to set the
55 compiler and compiler flags correctly and select the right
56 libraries to compile with.
57
58
59 If you want to have the game run in color, you will need the
60 XPM library. In this case, make sure that if you used options B
61 or C, the variable EXTRA_INCLUDES points to the directory
62 containing "xpm.h", and that EXTRA_LIBRARIES references the
63 directory containing the library "libXpm.a".
64
65 Last time I checked, XPM could be obtained by FTP from
66 export.lcs.mit.edu:contrib/libraries. Make sure your version of
67 XPM is up to date. The current pixmaps definitely work with
68 versions 3.2g and 3.3, but not with version 2. They should work
69 with version 3.4, too.
70
71 If the xsokoban window doesn't fit on your screen, the default
72 pixmaps may be too large. This is a problem if the vertical
73 height is less than about 800 pixels. In this case, try using
74 the pixmaps in bitmaps/36/ by changing the variable "BITPATH"
75 to point there.
76
77
78 Compile by typing "make". If something goes wrong, and you can track
79 down an error, send me a bug report (including what changes you needed
80 to make, and I will see about fixing it for later distributions).
81
82 Some systems have non-ANSI X header files, and you will need to
83 turn off function prototypes in those headers, or get better header
84 files. You will know this is happening if reams of errors start
85 popping up in "Xlib.h"
86
87
88 Play the game by typing "xsokoban". If it complains about not being
89 able to read the scorefile, create one with "xsokoban -c". If this
90 doesn't work, it is probably because you need to create the score
91 directory. See config.h.
92
93
94 Set ROOTDIR to the desired final location for the xsokoban
95 data files, and rebuild. Install the game by typing "make install" or by
96 manually copying the executable. Install the directories screens/,
97 scores/, bitmaps/, and saves/ under ROOTDIR.
98
99
100
101Credits
102
103 Unknown Hacker - Original curses(1) implementation.
104 Joseph L. Traub - X windows interface.
105 Kevin Solie - simultaneously developed X implementation (merged in).
106 Mark Linderman, Christos Zoulas - Mouse code (added to Solie's version).
107 Andrew Myers - Improved mouse UI, score ranking, WWW and color support
108
109Fixes, Bug Reports, and Modifications
110
111 If you make any changes to this program, fix any bugs, add any neat
112 features, or whatever, please send mail to andru@lcs.mit.edu
113 so that I can add them in to the newest release.
114
115Redistribution
116
117 XSokoban is distributed in the public domain and may be freely
118 redistributed. The standard anon FTP distribution site is
119
120 ftp.pmg.lcs.mit.edu:pub/xsokoban.
121
122 The WWW xsokoban home page is
123
124 http://xsokoban.lcs.mit.edu/xsokoban.html
125
126Play Safely!
127 XSokoban is an addictive and time-consuming game. Like any other
128 computer game, if played for long periods of time, xsokoban can put
129 stress on the tendons and nerves in your arm, causing injury. The
130 injury may not cause pain until it is advanced. Take breaks. Make
131 sure your computer setup is ergonomic. Use the user interface
132 intelligently.
133
134NO WARRANTY!
135
136 As free software, XSokoban comes with absolutely no warranty.
137 In no event will Andrew Myers or any other party be liable to
138 you for damages.
139
140Andrew Myers
141andru@lcs.mit.edu
142