************************************************************************
*           PSION 3a SOKOBAN Version 1.6 April 1995                    *
************************************************************************

Version 1.6
===========

:-( Three bugs managed to get into version 1.5, corrected in this version. 
	
	+  undo move crashed if the man was in the top row. (I'm used 
	   to C and keep forgeting OPL array indices start at 1!).
	+  couldn't have more than 99 levels - file load error.
	+  Psion-M for undo move didn't work in direct mode, although
	   it was ok from the menu.

:-) Can now be installed on any drive - M, A or B. 

Version 1.5
===========
Main changes from version 1.0 are :

	+  a 10x10 font rather than the original 8x8 making things
	   a bit easier on the eyes.
	+  two selectable fonts available with different "contrast", 
	   again to make things easier on the eyes.
	+  support for additional user-defined levels.

Just to reiterate the original acknowledgement, this implementation
is based on the original Unix version written by an unknown
hacker, with the levels dug out from a number of sources on the 
Internet.

Installation
------------

	+       Make the directory \SOK
	+       Copy    SOK*.FON, SCREEN.*, MAXLVL.* to \SOK
		( nb. if upgrading from a previous version, 
		      there's no need to copy the levels again 
		      ie. the SCREEN.* files )
	+       Copy SOKOBAN.OPA to the \APP directory
	+       Use Psion-I to install the Sokoban application

How to Play
-----------

Just use the "man" to push the "crates" into their storage locations
without getting trapped by walls, other crates etc. There are 90
levels to keep you busy for a while.

	+       arrow keys to move the "man" 
	+       <control><arrow> makes him run.
		nb. he will stop at a crate
	+       Psion-key combinations are:
			Psion - M   Undo Move
			Psion - L   Undo Level
			Psion - S   Save Position
			Psion - R   Restore Position
			Psion - F   Toggle Font
			Psion - X   Exit (saves level) 
	+       Menu key gives similar options.

Note : there is a cheat mode available which takes you on to the
next level. It's not hard to find, but if you get desparate drop
me a line at R.Czajkowski@herts.ac.uk. 


Adding New Levels
-----------------

There's a file called MAXLVL.90 in \SOK corresponding to the
number of levels defined by the SCREEN.* files. Currently there
are 90, so you can add additional levels as SCREEN.91, SCREEN.92 etc.
Assuming you added levels up to SCREEN.100, just rename the MAXLVL.90 
file to MAXLVL.100 and restore the previous game to play the new levels
(assuming you'd finished the existing 90!). The actual contents of the 
MAXLVL file are irrelevant.


Format of the SCREEN files
--------------------------

These can be created with any text processor or with the Word App,
in which case save the file as a text file, copy it to \SOK and
rename it SCREEN.<number>. Characters representations are :

		#                       Wall
		$                       Crate
		.                       Storage Location
		@                       Man
		<space>                 Ground

Remember there must be as many storage locations as there are crates!


Font Files (SOK*.FON)
---------------------

You can change these if you want to ... the characters above are
the only ones defined in these fonts (the program uses gLOADFONT
as necessary). I've used wsfcomp to create these, and the only 
restriction is fontsize must be 10x10.

There's a nice graphics version by Didier Pirottin posted about 
the same time as my 1.0 effort, but I find the gfx on the Psion 
a bit tough on the eyes, and I would imagine they could be a 
distraction in the later, trickier levels. (Didier's version is 
shareware so you only get 10 levels for free.) 


Bugs Etc.
---------

As far as I'm aware there aren't any. On the other hand I said that
last time, so on your own head be it!


Distribution
------------

Go forth and multiply ie. freely distributable. Please include this file 
in the distribution. Any comments, suggestions etc welcome. I'll 
incorporate any new levels or fonts you care to send me (uuencoded 
in email please) into the distribution.


Have Fun,

Roman Czajkowski                        R.Czajkowski@herts.ac.uk
7 Yew Tree Court
Fishery Road
Hemel Hempstead
Herts HP1 1NE, UK
+44 1442 255019

