NikNakk Patience
(c) Nick Kennedy 2004

This game currently plays two different versions of patience (or solitaire if
you're American). These are Klondike and FreeCell. Klondike is the game that
most people will simply know as Solitaire.

Licence
=======

This program is supplied as is, with no warranty. It may be freely distributed,
as long as all the accompanying files are distributed with it. The program
remains, however, my copyright. If you like it and it helps you while away some
time, you might like to consider giving me something via my paypal account. The
account email is devel@nick-kennedy.com.

The source will shortly be released under the Mozilla Public Licence, which can
be viewed at http://www.mozilla.org/MPL/.

Installation
============

This program requires the OPL runtimes to be installed. These are available from
http://opl-dev.sourceforge.net/opluiq.html . I have also provided them in the
zip with this program. Please install these first, and then install this
program.

Play
====

Playing is currently only possible by stylus. Clicking on a card selects it.
Clicking again on a different card/empty stack will move the card or cards to
that place. For games which have a face-down deck, clicking on it will move the
appropriate number of cards to the face-up pile. To assist with play, any cards
that can be moved to the foundations will automatically be done so, as long as
this does not limit further play options. This is optional, and may be changed
in the game preferences.

The game state is saved on exit, and also on switching game type. Game type can
be switched between using the 'Games' menu. Moves may be undone and redone using
the 'Edit' menu, but all move history is lost on exiting or switching game type.
Specific deals may be selected using the 'Select Deal' option of the 'Patience'
menu.

Both games feature a set of preferences, which allow the layout, the manner in
which cards are played and a few other options to be altered.

Bugs
====

There are known problems with the current release of the OPL runtimes. These
include the menu not being displayed on launch, and there being a small area to
the left of the menu which crashes the program. Hopefully these will be sorted
out soon in future releases of the runtimes. Any other bugs may be related to my
program, and I would be happy to receive bug reports at devel@nick-kennedy.com.

Specific game help:
===================

Klondike
========

In Klondike, the aim is to move all cards to the foundations. The foundations
are built up in suits from Ace to King. Cards may also be built onto the 7
columns of the tableau. These cards must be built down in descending rank, with
alternate colours. Whole sets of cards can be moved from one tableau stack to
another. However, only Kings can be placed in a blank tableau stack. There is
also a face-down deck, which initally contains 24 cards. The deck can be moved
through in steps of 3.

FreeCell
=======

In FreeCell, the aim is to move all cards to the foundations. The foundations
are built up in suits from Ace to King. Cards may also be built onto the 7
columns of the tableau. These cards must be built down in descending rank, with
alternate colours. Any card may be placed on a blank tableau column. There are
four 'cells', which can each contain one card. These cells can be used for
temporary storage of cards. When moving a set of cards from one tableau stack to
another, there must be sufficient free cells available. Since blank tableau
stacks can take any card, each blank stack (apart from the destination)
effectively increases the free cells available. There is no deck, and all cards
are face-up after the deal.

Release History
===============

1.00 - Now compatible with Series 60
     - Statistics
     - Score and time for Klondike
     - Various other smaller changes
0.72 - Minor cosmetic changes
0.71 - Minor cosmetic changes
0.70 - Added different card sizes
     - Changed foundations to allow any suit at start
0.60 - Changed background to dark green
     - Allowed dragging of cards
     - Allowed layout to be altered
     - Created preferences dialogs for both games
     - Fixed a couple of bugs
0.50 - Initial release

Ackowledgements
===============

Thanks to Ewan Spence for releasing the UIQ Event Core.
Thanks to Michal Jerz of www.my-symbian.com for all his work on the site, and
listing my program.
Thanks to Emma, Lapis, ReckaH@P900, chucky_egg, Bonzo, pcwizzard and lozrus for
feedback/suggestions.