/* * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *                       FREECELL                        *
 *                         v1.0                          *
 *                     for the HP48                      *
 *                          by                           *
 *                      Bert Knops                       *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * */

 date :                                   January 14, 1999


Hello,

Perhaps the word freecell sounds familiar to you. It's a
card game that is included in Windows 95. Ones you get 
the hang of it, it's quite addictive. That's why I 
decided to make a HP48 version of it.

Now how do you get so many cards on such a small screen?
By making the cards very small. You might have problems
reading them, but that's only temporary. I built in the
possibility to scroll, in case cards are outside the 
display.


How to play the game
====================

The rules are the same as in the Windows 95 version, but 
the game play takes a bit more effort.

Basically there are three areas where cards are: row 1
to 8, the stack and the aces. At the beginning all cards
are in the rows. The goal is to get all the cards to the
aces.

You can only move one card at a time.

The following moves are allowed:

* You can move a card from one row to another. The card 
  is taken from the end of one row and added at the end
  of the other. In order to move the card, it has to fit
  at the end of the row it's going to. That is, the
  number of the moving card has to be one less than the
  last card of the row it's going to. Also the color of
  the card has to be the opposite of the last card of 
  the row it's going to: red on black or black on red 
  (on the HP48 it's white and blue).

* You can move a card from a row to a free stack position.

* You can move a card from one stack position to another.

* You can move a card from a stack position to a row. The
  card has to fit at the end of the row.

* You can move a card from a row to the aces. On the
  aces, the cards are sorted by color (spades, clubs,
  etc.). The first card of a color that is moved to the
  aces, has to be the ace. The next cards have to be in
  order from 2 to king.

* You can move a card from stack to aces. The card has to
  fit on the aces.


Keys
====

             1 - 8 = Row 1 to row 8

           MTH PRG = The four stack positions
            '  STO

                 A = The aces

             ENTER = Undo your last move

          up arrow = Scroll up
        down arrow = Scroll down

         backspace = Restart the current game
               DEL = Start a new game
               +/- = Toggle sound on/off
  right shift - ON = Turn off the calculator
                ON = Exit the game
                     (saving the current status)


Installing the game on your HP48
================================

The game is in library format.

Transfer the library to your calculator.
Put it on the stack.
Enter a port number (0,1,2).
Press STO.
Turn your calculator off and than on again.

Now the game is installed.


Uninstalling the game
=====================

RTFM - Read the manual that came with your calculator.


Technical stuff
===============

library number : 1246
bytes          : 2726.5
checksum       : #9A2Ah

The game is written in system RPL and a little machine 
language. I only used RPL commands that are supported on 
all HP48's according to the document "Programming in 
System RPL" by Eduardo Kalinowski. As for the ML part, I 
got it from the news group comp.sys.hp48, and it was said
to be compatible with every HP48.

I tested the game on my HP48G, ROM revision M.

The game creates a variable named "freecdat", to save the
card positions. To prevent memory loss, don't change the
contents of that variable.


Copyrights
==========

You have the right to copy this game.


Have a nice day,

Bert

current email: bknops@tip.nl
