head	1.12;
access;
symbols
	v19:1.12
	v18:1.12
	v17:1.11
	v16:1.10
	v15:1.9
	v14:1.8
	v13:1.7
	v12:1.6
	v11:1.5
	v10:1.4
	v9:1.3;
locks; strict;
comment	@// @;


1.12
date	2002.02.19.07.44.11;	author sunshine;	state Exp;
branches;
next	1.11;

1.11
date	2002.01.29.20.03.34;	author sunshine;	state Exp;
branches;
next	1.10;

1.10
date	2002.01.17.16.40.14;	author sunshine;	state Exp;
branches;
next	1.9;

1.9
date	2001.12.23.15.14.40;	author sunshine;	state Exp;
branches;
next	1.8;

1.8
date	2001.08.28.21.03.17;	author sunshine;	state Exp;
branches;
next	1.7;

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

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

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

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

1.3
date	97.11.13.04.40.45;	author zarnuk;	state Exp;
branches;
next	1.2;

1.2
date	97.11.13.03.45.33;	author zarnuk;	state Exp;
branches;
next	1.1;

1.1
date	97.11.13.02.54.53;	author zarnuk;	state Exp;
branches;
next	;


desc
@@


1.12
log
@v18
-*- Added support for new triangular-style Trioban puzzles.
@
text
@Copyright (C)1997,2001,2002 by Eric Sunshine <sunshine@@sunshineco.com>

OVERVIEW
========
This is the source code for the NextStep port of SokoSave.  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
=============
SokoSave requires the MiscTableScroll palette, version 129 or better.  The most
recent version of MiscTableScroll for NextStep can always be obtained from the
MiscTableScroll home page:

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

MiscTableScroll for NextStep can also be downloaded from the following
location:

http://www.peak.org/next/sourcelibrary/misckit/MiscTableScroll.140.s.gnutar.gz
http://www.peak.org/next/sourcelibrary/misckit/MiscTableScroll.140.s.README

Build and install MiscTableScroll by following the instructions included in
that package before proceeding to the next section of this document.

BUILDING
========
Build and install SokoSave for NextStep by opening the PB.project file from
this directory in ProjectBuilder.  On the "Builder" 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 supported architectures:
NeXT, Intel, HPPA, and Sparc.

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.

SokoSave utilizes the MiscTableScroll palette, which is copyright (C)1994-1999
by Eric Sunshine <sunshine@@sunshineco.com> and Paul McCarthy
<zarnuk@@high-speed-software.com>.

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


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

-*- Updated the README files to mention hexagonal support.
@
text
@d48 6
a53 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.10
log
@v16: Augmented conclusion.
@
text
@d47 6
a52 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.9
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.

-*- 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>
d45 9
@


1.8
log
@v14 -- release 2.3
@
text
@d1 1
a1 2
Copyright (c)1997, Paul McCarthy
Copyright (c)1997,2001, Eric Sunshine
d3 5
a7 4
   From: "Paul McCarthy" <zarnuk@@high-speed-software.com>
   From: "Eric Sunshine" <sunshine@@sunshineco.com>
   Date: August 28th, 2001
Subject: SokoSave 2.3 Source Code.
d9 2
a10 2
SokoSave is a NextStep implementation of the Sokoban game.  This package
contains the source code for compilation under NextStep 3.3.
d12 1
a12 5
Highlights:
* Fast
* Convenient automated shortest-path movement.
* Unlimited undo/redo.
* Save/restore board positions.
d14 5
a18 7
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.  
d20 1
a20 4
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.
a21 20
These restrictions are for the protection of all.

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:

	"Paul McCarthy" <zarnuk@@high-speed-software.com>
	"Eric Sunshine" <sunshine@@sunshineco.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.  

NOTE: The SokoSave program requires the MiscTableScroll palette, version 129 or
better.  The most recent version of of MiscTableScroll for NextStep can always
be found in the download section of the High Speed Sofware web site:

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

d28 2
a29 3
To install:
cd ~/Source/Games               # Wherever you install source code.
gnutar xzf SokoSave.2.3.s.tgz   # Extract the source code.
d31 8
a38 2
No special permissions are required other than the ordinary permissions to 
create files in a directory.  
d40 2
d43 5
a47 2
SokoSave was written by Paul McCarthy.  Eric Sunshine added several new 
automated movement mechanisms, as well as other features.
a48 4
SokoSave uses the MiscTableScroll, which is copyright (c)1994-1999 by
Paul McCarthy <zarnuk@@high-speed-software.com> and Eric Sunshine
<sunshine@@sunshineco.com>.

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


1.7
log
@v13 -- 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.
@
text
@d6 2
a7 2
   Date: August 21st, 2001
Subject: SokoSave 2.2 Source Code.
d59 1
a59 1
gnutar xzf SokoSave.2.2.s.tgz   # Extract the source code.
@


1.6
log
@v12 -- release 2.1
@
text
@d6 2
a7 2
   Date: August 20th, 2001
Subject: SokoSave 2.1 Source Code.
d59 1
a59 1
gnutar xzf SokoSave.2.1.s.tgz   # Extract the source code.
@


1.5
log
@v11
-*- Updated Paul's email address, throughout, since the old one is no
    longer valid.

-*- Bumped release number from 1.1 to 2.0 since this release contains many
    functional improvements.

-*- README_ABOUT_SOURCE_CODE now explains how to obtain MiscTableScroll,
    which is needed to build the NextStep version of SokoSave.

-*- Added copyright notice for Eric Sunshine since, as of this release, he
    has written a fairly significant amount of code for the project.
@
text
@d6 2
a7 2
   Date: August 19th, 2001
Subject: SokoSave 2.0 Source Code.
d59 1
a59 1
gnutar xzf SokoSave.2.0.s.tgz   # Extract the source code.
@


1.4
log
@v10: Release 1.1
@
text
@d2 1
d4 4
a7 3
   From: "Paul McCarthy" <zarnuk@@mcgh.org>
   Date: December 10th, 1997
Subject: SokoSave 1.1 Source Code.
d9 2
a10 2
SokoSave is a NEXTSTEP implementation of the Sokoban game.  This package
contains the source code for compilation under NEXTSTEP 3.3.
d14 1
a16 2
* Left-click automatic shortest-path moves.
* Right-click automatic push-to-destination.
d37 2
a38 1
	"Paul McCarthy" <zarnuk@@mcgh.org>
d41 3
a43 3
included in officially published versions of the SokoSave program.  I do not 
want others taking credit for my work, and I will not take credit for the 
work of others.  
d45 3
a47 2
NOTE: The SokoSave program requires the MiscTableScroll palette, version 129
or better.
d49 8
d58 2
a59 5
cd ~/Source/Games                  # Wherever you install source code.
gnutar xzf SokoSave.1.1.s.tar.gz   # Extracts the source code.
cd SokoSave                        # Change to that directory
co RCS/unpack.sh,v                 # Check out the script to unpack.
./unpack.sh                        # Unpack the source.
d65 2
a66 2
Paul McCarthy wrote the program.
Eric Sunshine corrected some bugs and enhanced the preferences panel.
d68 3
a70 2
SokoSave uses the MiscTableScroll, which is copyright (c)1997, Paul McCarthy
and Eric Sunshine.
d72 3
a74 1
Comments to: "Paul McCarthy" <zarnuk@@mcgh.org>
@


1.3
log
@no comment.
@
text
@d1 1
a1 1
Copyright 1997, Paul McCarthy
d4 2
a5 2
   Date: November 13th, 1997
Subject: SokoSave Source Code.
d7 2
a8 1
SokoSave is a NEXTSTEP implementation of the Sokoban game.
d48 1
a48 1
gnutar xzf SokoSave.1.0.s.tar.gz   # Creates SokoSave
d58 1
d60 1
a60 1
SokoSave uses the MiscTableScroll, which is copyright 1997, Paul McCarthy
@


1.2
log
@Fixed handling of language subprojects.
@
text
@d49 2
a50 2
co *.lproj/RCS/* RCS/*             # Check out the source code from RCS.
./unpack_binaries.sh               # Unpack the nibs, tiffs, etc.
@


1.1
log
@v9
@
text
@d49 1
a49 1
co RCS/*                           # Check out the source code from RCS.
@
