<-------------------------- This file is this wide --------------------------->


                                                   ____     _  _  _  __
                                                  |    ||_||_>| ||_|| _
      ,-----------------.                         | *    | |_>|_||| |_/
        B L U E C H I P                           |   __    _ ___ __ _  _
      `-----------------'                         |  |_ |_||_  | |_ ||||_
                                                  |_:__| |  _| | |__| | _|



                               =============
                                 I N D E X
                               =============


                      Introduction to Klondike Solitaire

                                Installation

                                  Controls

                                   Display

                                 Source Code

                             Future Development

                                Bugs'n'stuff

                                   Greetz

                                   Author



-------------------------------------------------------------------------------



Introduction to Klondike Solitaire
==================================

xxx


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

Klondike Solitaire will work with:
  #  Archos Jukebox Recorder - Version 1 (AA Batteries)
  #  Archos Jukebox Recorder - Version 2 (Lithium Ion Battery(ies))
  #  Archos Jukebox Recorder FM

As Klondike Solitaire is distributed seperately from Rockbox, please place the 
file "card_Klondike.rock" in the directry ".\rockbox\plugins\" on your Jukebox.  
Klondike Solitaire can be then be found under "Plugins" in the Rockbox menu 
system.

Alternatively, you may like to place Klondike Solitaire in a directory of your 
own choosing and execute it directly by using the file browser.  For this 
method you will need to ensure that Rockbox is set to 
"Show All Supported Files".


Controls
========

xx


Navigation
==========

During the turn of a Human, the up, down, left and right cursor keys navigate
the board highlight in a suspiciously expected manner to the chosen square.
When the cursor is highlighting the square you wish to play in, press PLAY.  If
you have chosen an invalid move, the board will flash and you will be expected
to try again.

Button repeat _is_ enabled for navigation.

The AI opponents will pause slightly before making their move, to allow you to
see the result of your move.  If you wish to force the Computer opponent to
wait longer before playing, you may keep PLAY depressed ("keep your finger on
the piece you just played") and the Computer will make his move immediately you
remove your finger from the keypad.


Display
=======

xx


Source Code
===========

The source code well documented and available from the Cyborg Systems homepage.
Currently at:  http://homepage.ntlworld.com/cyborgsystems

Since I will not divulge my private details online, I have been banned from
submitting code to Rockbox officially.  So future work will only be available
from the Cyborg Systems homepage.

If you wish to use any of my code you are hereby granted full permission to do
so ONLY if you offer me some token credit for my efforts - that means putting
something like "Thanks to Bluechip for his help" on your "greetz" or "credits"
screen.  Or, if you do not have such a screen on in your application, then
simply offer me a token credit in a comment in your source code.
I will consider that fair payment/respect for my efforts.


Future Development
==================

xx


Bugs'n'stuff
============

I am pleased to hear about bugs I can fix - although they don't tend to happen
too often in my code ...go on then, find one! - LOL

If you can think of any clever short cuts I have missed - gimme a shout and I 
will explain anything that you may not fully understand at first.


Greetz
======

pajaco for his help with the graphics and concept shots
scott666 for his help with the random range algorithms in the shuffles


Author
======

BlueChip