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

                               ASokoban v1.0b

                         © 1993Panagiotis Christias
                                             
--------------------------------------------------------------------------------


================================================================================
===============  NOTICE : ASOKOBAN NEEDS KICKSTART 2.0  ========================
================================================================================

GENERAL
-------
    ASokoban is an implementation of the known UNIX game Sokoban for the Amiga.
It has the original 85 levels of the Unix game (that means that if have already
played the original game you will find ASokoban's stages familiar).

    Additionally, ASokoban has a nice user-friendly 2.0 GUI (designed with 
GadToolsBox), undo and backup functions, uses the best existing library
(ReqTools.lib) to popup all kind of requesters. It is fully multitasking, opens
its window in the workbench screen and can be iconified easily.

    For the ones who do not know the game (but still want to play it!) read the 
following:


INSTALLING ASOKOBAN
-------------------
    ASokoban does not need any special kind of installation, as a matter of fact
it does not need any kind of installation. You should only copy the Reqtools.lib
into your LIBS: directory (if it isn't already in there!) and you're ready.


STARTING ASOKOBAN
-----------------
    You can either start ASokoban from the CLI (ASokoban detaches itself nicely
from the CLI right after being launched) or the Workbench using its icon.


HOW IS ASOKOBAN PLAYED
----------------------
    You control a strange pair of eyes through the maze of each level. Your
purpose is to push all the pieces of money into the safe which is the colored
(blue) area of the maze. You can ONLY puss the money, you cannot pull them, pick
it up or anything else. The eyes can be moved using the cursor keys (best way)
or the mouse by pressing and holding down the left mouse button. Once you have
gathered all the money packets in the safe you can proceed to the next level.


GADGETS
-------
    The playfield is surrounded by several gadget. These are:

        New : Starts a new game.

        Undo : Undoes the last push (not the last move!)

        Set Level : Let's you choose the level to play. Actually it works only
                    backwards giving you the chance to play again previous 
                    levels.

        High Scores : Displays the high score list.

        About : easy...

        Backup : "Saves" temporarily your position (before a risky step)

        Restore : Restores the previously "saved" position.

        Name : Pops up a file requester to select the name of the file you want
               to save your position and highscores for another time. Note that
               your level position will be saved also in this file letting you
               continue the next time from the level you where. By default, the
               name of the file is "ASokoban.data". The name of the file is 
               displayed into the string gadget on the right of the 
               name-gadget. The filename can be changed also directly from the
               string gadget.

        Load : Loads the data file.

        Save : Saves the data file (happens automatically on exit).

    Extra informations are displayed on the right of the playfield. These are
the level, the total level money packets, the saved money packet, the totat
moves and pushes of the eyes.


HOW TO EXIT ASOKOBAN
--------------------
    You quit ASokoban either by pressing the close gadget or pressing 'q'.


HINTS & TIPS
------------
    No hint and tips. The game isn't easy but I can guaranty that every level
has its solution (maybe unique sometimes, but existing). 8^)


BUGS
----
    No known bugs. Sometimes when using the mouse to guide the eyes, they seem
to stick on the mouse pointer even when the mouse button isn't pressed. It's 
no real bug, it can even be useful moving the eyes quickly through the maze.
For those who may like this "feature" a certain way to cause it is to press
once the keyboard equivelent (LEFTALT+LEFTAMIGA) of the left mouse button.
Pressing once again the left mouse button things come back to normal.


DISTRIBUTION
------------
	ASokoban is giftware meaning that if you like you can send me anything
(money, your programs, PD software, postcards, pizzas etc.). It also means that
it is copyright of Panagiotis Christias 1993 © (me) and it's freely
distributable as long as all of its files are included in their original form
without additions, deletions, or modifications of any kind, and only a nominal
fee is charged for its distribution. This software is provided "AS IS" without
warranty of any kind, either expressed or implied. By using ASokoban, you agree
to accept the entire risk as to the quality and performance of the program.


ACKNOWLEDGEMENTS
----------------
    This project was started in order to explore and learn the new features
of KS2.0 . Special thanks to Commodore for KS2.0, Nico Frankois for ReqTools
Library, Jan van den Baard for GadToolsBox. All of them have done a splendid
work. Thanks!


THE AUTHOR
----------
	If you have any suggestions, found any bugs, want the source of ASokoban 
or just like the program you can contact me via e-mail (preferably) or 
snail-mail :
                                                                         ______
    e-mail: christia@theseas.ntua.gr                 "Thanks, Amiga     / / / /
         or phri@leon.nrcps.ariadne-t.gr               for not being   / / / /
                                                        a PC!"______  / / / /
    address:  Panagiotis Christias                            \ \ \ \/ / / /
              Argirokastrou 40, Papagou 15669                  \ \ \/\/ / /
              Athens, GREECE                                    \ \/\/\/ /
                                                                 \/\/\/\/
================================================================================
