Copyright (C)2001,2002 by Eric Sunshine <sunshine@sunshineco.com>

OVERVIEW
========
This is the source code for the C++Builder port of SokoSave for Microsoft
Windows.  The project may be built with C++Builder versions 4 and 5.  For a
list of other platforms on which SokoSave runs, as well as the license
agreement, consult the README.txt file in the top level directory of this
project.

The most recent version of SokoSave can always be obtained from the SokoSave
home page:

http://www.high-speed-software.com/sokosave

PREREQUISITES
=============
To create a self-extracting setup program for SokoSave, you will need
InnoSetup, the "freeware" setup program creation tool.  The most recent version
of InnoSetup can always be obtained from the InnoSetup home page:

http://www.jrsoftware.org/isinfo.htm

InnoSetup is not required if you plan to install SokoSave manually.  Manual
installation is a simple procedure, so this is certainly a viable option.

BUILDING
========
Build SokoSave by opening the "SokoSave.bpr" project file from this directory
in C++Builder.  From the "Project" menu, invoke the "Make SokoSave" menu item.
Once the project has been built, it can be installed either manually or
automatically.

To install manually, copy "SokoSave.exe" to a destination folder, such as
"C:\Program Files\SokoSave".  Next, from the top level directory of this
project, copy the "SCORES" file, and the "help" and "puzzle" directories to the
same destination folder.

To install automatically, create the self-extracting installation program
"soksetup.exe".  This program is created with InnoSetup, a setup program
creation tool.  Launch InnoSetup, open the "SokoSave.iss" file from this
directory, and press the "Compile" button on InnoSetup's toolbar.  InnoSetup
will place the generated "soksetup.exe" file in a subdirectory of this
directory named "setup".  "soksetup.exe" can be used to install SokoSave on any
number of computers.

To delete all of the temporary files generated by the build process, close the
SokoSave project in C++Builder and run the "clean.bat" script.

No special permissions are required other than the ordinary permissions to
create files in a directory.

CONCLUSION
==========
Paul McCarthy wrote the original version of SokoSave for NextStep.

Eric Sunshine added many new features, including several powerful automated
movement mechanisms for ease of game play; added support for hexagonal Hexoban
puzzles and triangular Trioban puzzles; generalized the core SokoSave game
logic and extracted it into a portable and reusable library; and ported
SokoSave to Microsoft Windows using C++Builder, and to MacOS/X, MacOS/X Server
1.0 (Rhapsody/YellowBox) for Mach and Windows, and OpenStep for Mach and
Windows.

Send comments to:
Eric Sunshine <sunshine@sunshineco.com>
Paul McCarthy <zarnuk@high-speed-software.com>
