Cribbage v1.08 Readme
=====================

Cribbage is a card game played between a player (you) and the computer.  The cribbage
board used is the standard 121 point board (around twice to win).

Cribbage was written using Speedsoft's Sibyl.  Source code is available on request or
from my web page at: http://pws.prserv.net/usinet.slack/

Card images were snaggled from the public domain QCard32.DLL and converted to OS/2
bitmaps.  Many thanks to Stephen Murphy and Daniel Di Bacco for the excellent card
images (and for making the QCard DLL public domain (Freeware)).

Use the program at your own risk :).

Fix history:
------------
2001-03-05  v1.00  Initial Release.
2001-04-16  v1.01  Fixed a bug in the analyze hand function.
2001-04-20  v1.02  More changes to the analyze hand engine.
2001-05-22  v1.03  Fixed a bug in the initial display of the cardback image in the 
                   options dialog.
2001-06-17  v1.04  Fixed (I think) the 'last card' point issue (player was not
                   getting it when they should at times).
2001-06-24  v1.05  Another fix for last card scoring, computer was not getting a
                   last card point after player went and computer played out.
2001-07-07  v1.06  Removed the last of the GOTO's from the analyze function.
2001-07-08  v1.07  Fixed a problem with new hand starts where not all of the discard
                   buttons were enabled.
2003-01-17  v1.08  Recompiled with 4-bit vs 24-bit card images to fix an issue with
                   Sibyl's TBitmap class and SDD/Snap drivers.

To install:
-----------
Unzip into a directory of your choice and run cribbage.exe.  You can also use the
included 'cribinst.cmd' script to create an icon on the desktop that you can drag
to a different folder.

Options:
--------
The Cribbage program allows the setting of several options.  Access the settings dialog
by pressing the settings button on the main window.
General options include:
 Prompts On: If checked, Turns on prompts at various points in the game (quit, new game,
             etc.).
 Always Starts: If checked, the player gets the first crib on each new game (not hand).
 Sounds On: If checked, the cribbage pins 'beep' the computer (not MMOS2) sound chip 
            while moving.
 Verbose Messsages: If checked, the game displays a message before everything.  This
                    option should only be used if you can't keep up with who is doing
                    what when.
The card back option allows the choice of the image to use for the card backs.  To see
the image selected, double click on the number in the list box.
Options selected are saved if OK is pressed, otherwise they are not changed.

To play:
--------
Note: You should have some idea of how Cribbage is played in order to get the most 
enjoyment from this game.
Start a new game by pressing the 'Play Game' button.  If the 'always start' option is not
checked, the first crib is selected randomly, otherwise, the player gets first crib (and
starts the hand).
The player then is shown their 6 cards.  Two of them must be selected to discard into
the crib.  As soon as two are selected (by pressing the 'discard' button under the 
selected card), the continue button is enabled.  If more than two cards are selected
for discard, the continue button is disabled again.  To unselect a card, press the 'keep'
button.
Game play now starts for the hand.  Select the card you want to play by pressing the
'play' button.  If you don't have a play, select the 'go' button.  Play continues until
all cards are played and the each hand is scored (starting with the player who does not
have the crib, followed by the crib holder, then the crib hand).  If points are missed
by the player, the computer will know and will grab those points for itself.  Unfortunately,
the computer never misses any of its points :).  The game continues with new hands (and
the crib swapping players) until a player reaches 121 points.  The first one to 121 wins
the game.
At any time, the 'new game' button can be pressed to start over with a new game.

Known problems/issues:
----------------------
Originally a DLL was created to store and retrieve the card images from.
Unfortunately, using the DLL leads to memory leaks.  Consequently, Cribbage links
all of the images into the exe produced.  This may be rectified in the future.

Contact:
--------
Michael G. Slack (slack@attglobal.net)