FreeCell v1.1
by Ben Mickle
bmickle@yahoo.com
January 13, 2001

--- Introduction ---

   Over a year ago, I made this game in about two weeks.  And now, about
sixteen months later, I've updated it.  The first release was really quite
thorough, but a lot people wanted a save game feature.  I was reluctant
to add that feature because it would make the program larger and I already
thought it seemed too large.  Then, Kirk Meyer released Lite86 II, a
compression tool that allows compressed programs to use writeback.  So,
I added the save game feature and made a few other improvements (which
took me less than an hour).  Now, thanks to compression, this version is
actually smaller than the original v1.0.

   I just whipped this game up in a few days.  It's based on the game
that comes with Windows.  I always enjoyed playing it when I was bored,
so I figured it would be nice to have on my calculator, too.  And, since it
hasn't been done before on a calculator I decided it would be a good little
project.  This game is really quite complete.  I don't plan on releasing
any more versions.


--- Installation ---

1. Send freecell.86p to your calculator.
2. To play, run Asm(freecell from the home screen or a shell.


--- Playing the Game ---

   I'm sure many people know how to play this game, but for those of you who
don't, here's my best explaination:  The object of FreeCell is similar to
Solitaire - you must get all the cards piled up in order by suit in the four
boxes on the top right of the screen.  The four boxes on top left of the
screen are "cells" that you can put any card in to arrange the cards 
properly.  It's a pretty fun game once you get the hang of it.


--- Keys ---

At the title screen:
 [F1] - Start a new game
 [F2] - View Statistics
 [EXIT] - Go back to TI-OS or shell
In the game:
 Up / Down / Left / Right - Move the arrow
 [2nd] - Select a card or place a selected card
 [+] - Make the width between the cards greater
 [-] - Make the width between the cards less
 [EXIT] - Quit your game
 [MORE] - Bring up options menu
 [DEL] - Teacher Key - Save game and return to home screen
At the options menu:
 [F1] - Quit your current game and start a new one
 [F2] - View Statistics
 [F3] - Clear Statistics
 [F4] - Resume your current game
 [F5] - Turn off the calculator
 [EXIT] - Leave options menu and resume your current game


--- Version History ---

version 1.0 - Initial release - September 9, 1999
	- Game play complete 
	- Grayscale
	- Statistics

version 1.1 - January 13, 2001
	- Improved key input
	- Improved random board
	- Teacher Key/Save Game - press [DEL]
	- Compressed with Lite86 II

--- Other Notes ---

	- When the screen flashes, it means you only have one legal move left.
	- If possible, cards that are no longer needed on the board are moved
	  to the stacks at the top of the screen.  For example, if both red
	  3's are already in the stacks, the black 4's will be moved up 
	  to the stacks automatically when they are availible.
	- Unlike solitaire, in FreeCell, you cannot move a pile of an
	  unlimited number of cards.  You may only move as many cards as
	  the number of cells available allow you to move.  For example, you
	  can move a pile of four cards only if you have at least three free
	  'cells' (empty columns are included).  In fact, what is really
	  happening when you move a pile of cards is all the cards you
	  want (or are allowed) to move are moved into free cells and empty
	  columns.  Then, they are piled up again in the spot you are moving
	  them to.
	- Any time you leave your game or start a new game, a loss is put
	  in the statistics.
	- Press [DEL] at any time during your game to save the game and
	  return to the home screen.  When you run the game again, your
	  previous game will be automatically restored.


--- Thanks ---

   Michael Pearce - for Solytare
   Jimmy Mardell - for porting Solytare to the 86
   Kirk Meyer - for Lite86 II
   Blackbelt - for beta testing
   Microsoft - for FreeCell on the PC


--- About Me ---

   I am 16 years old and I'm in 11th grade in the International
Baccalaureate program at my high school in Virginia, USA.
   Send any bug reports, questions, comments, suggestions, etc. to
bmickle@yahoo.com  For the most recent version of Freecell and my other
games and programs visit http://bolt.icestorm.com/bmickle


--- Disclaimer ---

   I am not responsible for anything caused by this program.  You may not
sell this program to anyone for money.  It is intended for free distribution.


DO NOT SEPARATE THIS DOCUMENT FROM FREECELL