packages icon
Stones of Asterind
Version 0.9

Matthew J. Gelhaus (mgelhaus@proaxis.com)
March 30, 1999

This is a game, written in C and utilitizing the GTK+ toolkit.  It is an
enhanced version of the classic board game Mastermind.  This version is
currently only for one player, and the computer randomly chooses the code
to break.

Sorry, there aren't any instructions on how to play the game here (yet), but
it's pretty easy to figure out.  Searching for "Mastermind" at Yahoo will give
you a list of web sites covering the game, so you can probably find good
instructions there.

LICENSING TERMS:

    Copyright (C) 1999  <Matthew J. Gelhaus mgelhaus@proaxis.com>

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
    
    To view the General Public License in its entirety, check the file
    LICENSE.

DISCLAIMER:

This is a work still under development, and as such I do not guarantee
it will work (see LICENSING TERMS above).  However, please send bug
reports to me (mgelhaus@proaxis.com), along with as much information
as you can.

SYSTEM REQUIREMENTS:

This package requires that the GTK+ toolkit (available at http://www.gtk.org)
is installed.  I have successfully tested this game with GTK+ versions
1.0.6 and 1.1.5, but any of the more recent versions should work as well.  If
you find it does NOT work with your version of GTK+, please send me a bug
report, along with the GTK+ version you have and any other information you
think might be helpful.  Send bug reports to me at mgelhaus@proaxis.com.

INSTALLATION INSTRUCTIONS:

I haven't looked into using GNU autoconf yet, so for now you have to build
it manually (sorry).

1.  Unpack the archive and cd into its directory.  For example,

    $ tar zxvf stones-0.9-src.tar.gz
    $ cd stones-0.9
    
2.  If desired, edit the Makefile.  This should only be necessary if you
    want compiling options other than -Wall and -m486.  It might be necessary
    to explicitly state where your file gtk-config is.
    
3.  Type 'make'.

4.  If desired, copy the game into an executable directory.  For example,

    $ cp stones /usr/local/games/  (do this as root)

5.  Play the game!  Have fun!

    $ ./stones
    
    or
    
    $ stones  (if it is in your path)

Please, please, please report any bugs to me at mgelhaus@proaxis.com.  This
includes installation instruction bugs, because I was doing this from
memory!