head	1.4;
access;
symbols
	v19:1.4
	v18:1.4
	v17:1.3
	v16:1.2
	v15:1.1;
locks; strict;
comment	@// @;


1.4
date	2002.02.19.07.44.13;	author sunshine;	state Exp;
branches;
next	1.3;

1.3
date	2002.01.29.20.04.13;	author sunshine;	state Exp;
branches;
next	1.2;

1.2
date	2002.01.17.16.39.51;	author sunshine;	state Exp;
branches;
next	1.1;

1.1
date	2001.12.21.21.47.54;	author sunshine;	state Exp;
branches;
next	;


desc
@@


1.4
log
@v18
-*- Added support for new triangular-style Trioban puzzles.
@
text
@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>
@


1.3
log
@v17
-*- Added support for the new hexagonal-style puzzles.

-*- Updated the README files to mention hexagonal support.
@
text
@d58 6
a63 5
movement mechanisms for ease of game play; added support for hexagonal 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.
@


1.2
log
@v16: Augmented conclusion.
@
text
@d57 6
a62 6
Eric Sunshine added a number of new features, including several powerful
automated movement mechanisms for ease of game play; 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.
@


1.1
log
@v15
-*- Extracted core game logic out of GUI code and generalized it so that
    the same core code can be used by any platform.  Logic from
    SokoBoard.m now resides in SokoPuzzle.c, etc.

-*- Created a native Windows port of SokoSave using C++Builder.  The
    back-end logic for this port is provided by the new "sokocore" common
    code which used to be merged with the UI code for the
    OpenStep/NextStep ports.  From the user-experience, this port is
    nearly identical to the existing OpenStep and NextStep ports.  Builds
    successfully with C++Builder versions 4 and 5.

-*- Added a shortcut toolbar for quickly starting new games, opening saved
    games, saving games, launching the scores panel, and launching the
    help file.  Added a toggle-switch to the preferences panel to control
    presence of toolbar.  From the user-standpoint, this is the only major
    difference from the OpenStep/NextStep ports, since they do not feature
    a shortcut toolbar.

-*- Created an InnoSetup installer script for SokoSave.  This scripts
    facilitates the creation of a stand-alone "setup" program
    (soksetup.exe) for SokoSave.  With this program, Windows users can
    download and install SokoSave in a fashion in which they are already
    familiar.
@
text
@d1 1
a1 1
Copyright (C)2001 by Eric Sunshine <sunshine@@sunshineco.com>
d55 9
@
