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

OVERVIEW
========
This is the source code for the Cocoa/OpenStep port of SokoSave.  The source
code in this directory can be used to build SokoSave for the following
platforms:

    MacOS/X
    MacOS/X Server 1.0 for Mach (Rhapsody)
    MacOS/X Server 1.0 for Microsoft Windows (YellowBox)
    OpenStep 4.2 for Mach
    OpenStep 4.2 for Microsoft Windows

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

BUILDING
========
To build and install SokoSave on MacOS/X, open SokoSave.pbproj in
ProjectBuilder, select the "install" target, and then press the "Build" button.

To build and install SokoSave on MacOS/X Server 1.0 (Rhapsody/YellowBox) or
OpenStep, open the PB.project project file from this directory in
ProjectBuilder.  On the "Build" panel, select the "install" target, and then
press the "Build" button.  If you would like to build SokoSave for multiple
architectures, press the "Options" button and choose the desired architectures.
SokoSave may be built for any of the architectures supported by the particular
platform, as indicated below.

    Platform                        Architectures
    --------                        -------------
    MacOS/X                         PowerPC
    MacOS/X Server 1.0 for Mach     PowerPC, Intel
    MacOS/X Server 1.0 for Windows  Intel
    OpenStep for Mach               Intel, NeXT, Sparc
    OpenStep for Windows            Intel

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

PLATFORM NOTES
==============
Microsoft Windows

Be aware that the Apple/NeXT makefiles do not deal well with spaces embedded in
pathnames.  Therefore, for best results, avoid building the project from a path
which contains spaces.  Likewise, avoid installing the project into a path
which contains spaces.  This warning is especially relevant for pathnames such
as "C:\My Documents" and "C:\Program Files".  It is recommended that you adjust
the project's "Install In" property via the "Project Inspector" before
installing SokoSave in order to ensure that it is installed at a suitable
location.  This warning only applies to the build and install operations which
are controlled by the makefiles.  Once you have successfully built the
application, you may freely move it to a path, such as "C:\Program Files",
which contains embedded spaces.

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.

Matt Reda <mreda@mac.com> created the project file and Aqua-compatible
main-menu resource for the MacOS/X port of SokoSave.  He also patiently and
iteratively provided important feedback about the appearance of SokoSave's
windows and controls in MacOS/X's Aqua environment.

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