head	1.7;
access;
symbols
	v19:1.7
	v18:1.7
	v17:1.6
	v16:1.5
	v15:1.5
	v14-1:1.4
	v13-1:1.3
	v12-1:1.2
	v11-1:1.1;
locks; strict;
comment	@# @;


1.7
date	2002.02.19.07.44.15;	author sunshine;	state Exp;
branches;
next	1.6;

1.6
date	2002.01.29.20.04.53;	author sunshine;	state Exp;
branches;
next	1.5;

1.5
date	2001.12.23.20.23.58;	author sunshine;	state Exp;
branches;
next	1.4;

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

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

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

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


desc
@@


1.7
log
@v18
-*- Added support for new triangular-style Trioban puzzles.
@
text
@Copyright (C)1997,2001,2002 by Eric Sunshine <sunshine@@sunshineco.com>
Copyright (C)1997 by Paul McCarthy <zarnuk@@high-speed-software.com>

OVERVIEW
========
SokoSave is an implementation of the game Sokoban for Microsoft Windows,
MacOS/X, MacOS/X Server 1.0 (Rhapsody/YellowBox), OpenStep, and NextStep.  This
is the developers' project package for SokoSave.  It contains only RCS
(Revision Control System) administrative files.  If you are interested in
building SokoSave from source code, then you should probably download the
friendlier SokoSave source code package, rather than using this package.

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

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

HIGHLIGHTS
==========
* Supports Sokoban, Hexoban, and Trioban puzzles.
* Fast.
* Convenient computer-assisted movement.
* Unlimited undo/redo.
* Save/restore board positions.

LICENSE
=======
SokoSave is "freeware".  You may use and enjoy this program for free.  This
package contains the source code for the SokoSave program.  You may examine,
use and modify the source code for private, non-commercial purposes free of
charge.  You may make and distribute unmodified copies of this source code for
free provided that: (a) the source code is distributed in its entirety without
modification, and (b) no fee of any kind is collected for the distribution of
the source code.

You may not distribute modified versions of the SokoSave program.
You may not distribute modified versions of the source code.
You may not distribute versions of the SokoSave program constructed from
modified versions of the source code.

These restrictions are for the protection of all.

If you would like some or all of your private modifications incorporated into
the officially published version of the SokoSave program, submit the modified
version of the source code to:

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

Credit will be given to all contributors for whatever contributions are
included in officially published versions of the SokoSave program.  We do not
want others taking credit for our work, nor will we take credit for the work of
others.

UNPACKING
=========
To utilize this package, check out and run the "unpack.sh" script:

gunzip SokoSave.*.tgz            # Uncompress the package.
gnutar xf SokoSave.*.tar         # Extract the RCS files.
cd SokoSave
co -p util/RCS/unpack.sh,v | sh  # Check out and unpack entire project.

After performing these steps, read the file README.txt in the top-level project
directory to learn how to build SokoSave.

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.6
log
@v17
-*- Added support for the new hexagonal-style puzzles.

-*- Updated the README files to mention hexagonal support.
@
text
@d20 1
d22 1
a22 1
* Convenient automated shortest-path movement.
d75 6
a80 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.5
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.

-*- Rewrote the OpenStep port so that it utilizes the new "sokocore" game
    library rather than implementing that logic directly.

-*- Rewrote the NextStep port so that it utilizes the new "sokocore" game
    library rather than implementing that logic directly.

-*- Rewrote and/or updated all of the README files for both source and
    binary distributions to reflect the new conglomerate package.
@
text
@d1 1
a1 1
Copyright (C)1997,2001 by Eric Sunshine <sunshine@@sunshineco.com>
d73 6
a78 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.4
log
@v14.1 -- release 2.3
-*- Added a warning to README_ABOUT_SOURCE_CODE and README_ABOUT_RCS
    regarding the negative impact on the Apple/NeXT makefiles of spaces in
    pathnames.
@
text
@d1 2
a2 2
Copyright (c)1997, Paul McCarthy
Copyright (c)1997,2001, Eric Sunshine
d4 8
a11 4
   From: "Paul McCarthy" <zarnuk@@high-speed-software.com>
   From: "Eric Sunshine" <sunshine@@sunshineco.com>
   Date: August 28th, 2001
Subject: SokoSave 2.3 Developers' Source Code as RCS files.
d13 2
a14 5
SokoSave is a MacOS/X, MacOS/X Server 1.0 (Rhapsody), and OpenStep
implementation of the Sokoban game.  This is the developer's source code
package for MacOS/X, MacOS/X Server 1.0 (Rhapsody) for Mach & Windows, OpenStep
4.2 for Mach & Windows (Yellow Box), and OpenStep 4.1 for Mach.  It contains
only RCS files.  To utilize this package, see the instructions below.
d16 11
d30 4
a33 4
charge.  You may make and distribute unmodified copies of this source code
for free provided that: (a) the source code is distributed in its entirety
without modification, and (b) no fee of any kind is collected for the
distribution of the source code.
d42 3
a44 3
If you would like some or all of your private modifications incorporated
in the officially published version of the SokoSave program, submit the
modified version of the source code to:
d46 2
a47 2
	"Paul McCarthy" <zarnuk@@high-speed-software.com>
	"Eric Sunshine" <sunshine@@sunshineco.com>
d49 4
a52 4
Credit will be given to all contributors for whatever contributions are 
included in officially published versions of the SokoSave program.  We do not 
want others taking credit for our work, nor will we take credit for the work
of others.  
d54 6
a59 3
To utilize this package, checkout and run the `unpack.sh' script:
gunzip SokoSave*.tgz     # Uncompress the package.
gnutar xf SokoSave*.tar  # Extract the RCS files.
d61 1
a61 2
co RCS/unpack.sh,v       # Extract the unpack.sh script.
sh ./unpack.sh           # Checkout RCS files and unpack binary archives.
d63 2
a64 1
After unpacking the source code, read the README_ABOUT_SOURCE_CODE document.
d67 1
a67 5
create files in a directory.  The Apple/NeXT makefiles do not deal well with
spaces embedded in pathnames so, for best results, avoid building in, or
installing into paths which contains spaces.  This warning is especially
relevant for Microsoft Windows which often employs pathnames such as
"C:\My Documents" and "C:\Documents and Settings".
d69 3
a71 7
The source code in this package compiles on the following platforms:
    MacOS/X for Mach
    MacOS/X Server 1.0 for Mach (Rhapsody)
    MacOS/X Server 1.0 for Windows (Yellow Box)
    OpenStep 4.2 for Mach
    OpenStep 4.2 for Windows
    OpenStep 4.1 for Mach
d73 6
a79 4
SokoSave was written by Paul McCarthy.  Eric Sunshine added several new
automated movement mechanisms, as well as other features, and ported SokoSave
to MacOS/X, MacOS/X Server 1.0 (Rhapsody), and OpenStep.

d81 2
a82 2
"Paul McCarthy" <zarnuk@@high-speed-software.com>
"Eric Sunshine" <sunshine@@sunshineco.com>
@


1.3
log
@v13.1 -- release 2.2
-*- Fixed springiness on "Animate" and "Stop" controls on SokoBoard
    window.  This got botched when I swapped the position of these two
    controls at the last minute in v11.1.
@
text
@d6 2
a7 2
   Date: August 21st, 2001
Subject: SokoSave 2.2 Developers' Source Code as RCS files.
d52 5
a56 1
create files in a directory.
@


1.2
log
@v12.1 -- release 2.1
@
text
@d6 2
a7 2
   Date: August 20th, 2001
Subject: SokoSave 2.1 Developers' Source Code as RCS files.
@


1.1
log
@v11.1
-*- Added a README_ABOUT_RCS document.
@
text
@d6 2
a7 2
   Date: August 19th, 2001
Subject: SokoSave 2.0 Developers' Source Code as RCS files.
@
