Klondike Version 1.3 for Pilot
Copyright (c) 1996,97  Bill Kirby


Revision History:

-- Version 1.3 --

New Features:  - Added graffiti strokes for undo (backspace) and
                 autoplay (space).

Fixed bugs:    - Using undo on moves that were made with the autoplay
                 feature would sometimes corrupt the game, causing the
                 following problems:
                      
                   - fatal reset
                   - face-down cards would appear in ace piles
                   - cards would disappear from the deck, making it
                     impossible to win

               - Using autoplay to move all the visible cards in the
                 discard pile would leave the discard pile empty even
                 if there were more cards underneath.
               - If certain cases, options might not correctly be
                 changed when exiting from the preferences dialog.
               - Menu wouldn't work during the 'congrats' animation
                 after a game was won.
               - Quitting and restarting Klondike would not end the
                 'congrats' animation.
               - After winning a game, vegas score would be drawn in
                 large font.
               - After resetting statistics, the vegas rules total
                 would sometimes not display properly until you quit
                 and re-opened the statistics dialog.

Known bugs:    - With the deck at the bottom of the screen, long columns
                 of cards will overwrite the deck and discard area, leaving
                 garbage behind on the screen. 

-- Version 1.2 --

New Features:  - Vegas Rules now includes a score.  You start at -$52,
                 and receive $5 for each card moved to the ace piles.
               - Statistics now include win/lose streaks.
               - Statistics include the total amount of money won/lost
                 playing with the vegas rules option.
               - Statistics can be reset.
               - User specifiable shuffle.  You can set the number of
                 times the deck is shuffled before each game.

Fixed bugs:    - Blank screen when you launch Klondike from PAL, Launcher,
                 or AppHack.
               - In tap mode, if you tried to undo while there were cards
                 selected, the selected cards would disappear.
               - In tap mode, if you had any cards selected when you switched
                 to another app, Klondike would start a new game the next
                 time you launched, instead of contining the old game.
               - 'too many invalid regions' error when a game is won.
               - in certain situations, after selecting 'undo', the
                 number of cards shown in the discard pile would be
                 incorrect.
               - the bottom 2 pixels of each card column were not being
                 erased, causing card remnants to be left on the screen
                 when a large column was moved.

-- Version 1.1 --

New Features:  - UNDO!  Undo the last move by pressing the page-down
                 button.  Registered version allows you to undo the
                 last 100 moves.  Unregistered version will only undo
                 the last move.
               - Vegas rules.

Fixed bugs:    - restrictions on # of passes through deck is now an
                 option (vegas rules)
               - The "two of diamonds bug" is fixed.


-- Version 1.0 --

New features:  - Cool graphics when you win.  Ok, they're not really
                 all that cool, but they're better than nothing. :)
               - Page-up key moves as many cards as possible to the
                 ace piles.  Very handy for finishing off a game that
                 you've won.
               - Optimized drawing code, to (hopefully) help with the
                 battery drain problem.
               - Statistics: # of games won/lost is recorded.
               - Splash screen (which can be turned off in the registered
                 version)

Fixed bugs:    - Drawing one at a time now correctly restricts you to
                 one pass through the deck.
               - Switching between draw one/draw three will now force a
                 new game.
               - Discard pile never shows more than one card when in
                 'draw one' mode.
               - Annoying text at the bottom of the screen was replaced
                 with an annoying splash screen.
               - Fixed a bug in tap mode that may have been causing
                 excess battery drain


-- Version 0.91 --

This version just removes the backup bit from the .PRC file, so it
doesn't get backed up every time you hotsync.  Otherwise, it is
identical to 0.9


-- Version 0.9 --

New features:  - Added "tap mode" to allow playing game without dragging
                 cards around.  This helps reduce battery drain, as well
                 as prolonging the writing surface.
               - Configurable game layout.  Move the deck to any corner
                 of the screen

Fixed bugs:    - "Frozen stack" problem.
               - clicking on an empty column would cause strange behavior
                 later in the game (duplicate cards, frozen ace-pile)

Known bugs:    - battery drain problem.  I'm optimizing the drawing
                 routines to help reduce the battery usage.  These
                 improvements will be in version 1.0.  Until then, the
                 "tap mode" should require much less power, since it is
                 not constantly drawing to the screen.
               - I didn't get around to fixing any of the known bugs
                 listed below in version 0.8.  They are all fairly
                 cosmetic, and will be fixed in version 1.0

-- Version 0.8 --

New features:  - larger font used for rank.
               - preferences now work, allowing you to choose between
                 drawing one or three cards.
               - preferences allow setting a larger bitmap to be used
                 for the suit (on cards that are not covered by another
                 card)

Fixed bugs:    - hideous cross-hatch pattern removed from ace piles.
               - cards no longer disappear when dropping onto large
                 stacks.
               - double clicking on a card in the discard pile will
                 now move it to the ace pile.
               - attempting to drag from an empty ace pile no longer
                 results in a face-down card being dragged.

Known bugs:    - draw one mode allows you to go through deck as many
                 times as you want, instead of stopping after one time.
               - can switch between draw one and draw three in the
                 middle of a game.
               - when in 'draw one' mode, if you drag a card off the
                 discard pile and then let it go (so that it goes
                 back to the discard pile), it will not cover up the
                 top card.  Instead it will be next to the top card
                 (as if you were playing in draw three mode).
               - the text at the bottom of the screen will start to
                 disappear if you have stacks of cards larger than
                 ten.

-- Version 0.7 --

New features:  - Double-clicking cards will automatically move them
                 to an ace pile if possible.
               - state is now saved, so you can switch apps and come
                 back to the game later.
               - New Game menu option works.

Fixed bugs:    - a bug that allowed you to drop a multi-card stack on
                 to an ace pile (if the bottom card on the stack could
                 be legally placed there)

-- Version 0.6 --

Fixed a shuffling bug that caused duplicate cards.


-- Version 0.5 -- 

This is the basic game of Solitaire that everyone
knows how to play.  It's a preliminary version, but
it is playable.  Let me know what you think of it so
far.  


--
Bill Kirby
bkirby@electronhut.com
http://www.electronhut.com/pilot/

