===============
Card Games v1.1
===============

This package contains a collection of simple card games using a VGA
mode (640x480x16) and mouse.


------------
Requirements
------------
* svgalib 0.91 or later (in theory, tested with 1.07).
* An svgalib compatible mouse.

------------
Installation
------------
* Edit the Makefile, changing BINDIR, LIBDIR and PREFIX, if necessary.
  The PREFIX is to avoid clashes with other programs with the same
  name (such as the X11 game spider).  I suggest using vga_ or nothing
  as the prefix.
* Type 'make'.
* As root, type 'make install'.

------
Thanks
------
* Harm Hanemaayer <hhanemaa@cs.ruu.nl>,
  Michael Weller <eowmob@exp-math.uni-essen.de>,
  and other contributors for svgalib.
* Rob Malouf <malouf@csli.stanford.edu> for (unknowingly) contributing
  the font from dvgt (a very nice dvi viewer).
* Jacques Ge'linas <gelinas@cmr.ca> for reporting the problem of the
  non-existent mouse and providing patches for klondike for cycling
  the stock which prompted the 1.1 changes.

-----
Notes
-----
* In addition to the mouse, there are keyboard shortcuts for the grey
  buttons presented on the right of the screen: n for New Game, r for
  Restart, u for Undo, q for Quit.  These allow you to quit even if you
  don't have a mouse.  As a bonus, the interrupt character (often ^C)
  also works.

----------
Known Bugs
----------
* The playing card images aren't very good.
* The "Oh Hell!" computer players are pretty stupid.

------
Wanted
------
Somebody to create good looking artwork for this game, particularly
the playing cards.  For the cards, please restrict yourselves to a
width of 53 pixels and the colours white, black, red, blue and
yellow.  Send any image type (that the pbm tools know about), or my
playing card format.

--------
Feedback
--------
All feedback should be sent to evan@cs.mu.oz.au.

---------
ChangeLog
---------
1.0	25 Apr 1994	First Linux version completed:
			Oh Hell! v1.0, Spider v1.0, Klondike v1.0,
			Solitaire v1.0
1.1	 5 May 1994	Oh Hell! v1.1, Spider v1.1, Klondike v1.1,
			Solitaire v1.1

#######################################################################

==========
Game Notes
==========

--------
Oh Hell!
--------

The aim of Oh Hell! is to win exactly the number of tricks that you
bid.

First bid the number of tricks you expect to win (using the
appropriate grey button).  There is no restriction on the sum of all
the bids (it's ok for it to be the total number of tricks).

The card in the middle of the table indicates the trump suit.  The
last hand (with 13 cards) is played with no trumps.

If the bid is made, the player scores 10 + #tricks won.

ChangeLog:
1.0	25 Apr 1994	First Linux version completed
1.1	 5 May 1994	Keyboard shortcuts for major buttons added
			Minor code reorganization


------
Spider
------

The standard solitaire game of spider, much like the X11 version.

The primary differences compared to the X11 version are the lack of
hint and scoring functions, and the left button is used for
"dragging" cards as well as selecting.

If the player clicks on a card, the game will try to decide where the
card should go (if it can go anywhere).  If the player doesn't agree,
the card must be "dragged" to its intended destination.

ChangeLog:
1.0	25 Apr 1994	First Linux version completed
1.1	 5 May 1994	Keyboard shortcuts for buttons added
			Minor code reorganization


--------
Klondike
--------

The standard solitaire game of klondike.

By default, this version progresses through the stock one card at a
time and only goes through the stock once.  

Using the command option -m N, it can be changed to progressing through 
the stock N cards at a time, and going through the stock N times.  A 
common way of playing klondike can be emulated with -m 3.

Using the command option -c, the stock will be gone through an
infinite number of times.  Pressing the mouse button on the empty
stock each time resets it.  Using this option and not -m is probably
cheating.

ChangeLog:
1.0	25 Apr 1994	First Linux version completed
1.1	 5 May 1994	Keyboard shortcuts for buttons added
			Minor code reorganization
			Added options -c and -m


---------
Solitaire
---------

The first solitaire game I was ever taught.  I've never seen it
described anywhere, so I don't know its name.  If anyone does know its
name, please send me mail and tell me.

Unlike the previous two solitaire games, in this one a card may only
be put on the card with the next highest rank in the same suit.
However, any card which is face up may be moved.

Like klondike, only kings may be moved into empty columns.

The aim is to get the each suit into a single column, K down to A.

ChangeLog:
1.0	25 Apr 1994	First Linux version completed
1.1	 5 May 1994	Keyboard shortcuts for buttons added
			Minor code reorganization

