PalmJongg Copyright (c) 1997 Tan Kok Mun
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This is the shareware version of PalmJongg 1.9 for Pilot. Please read
REGISTER.TXT for more information.

The latest version of this software can be found at :
     http://home.pacific.net.sg/~kokmun/palmpilot.htm


CONTENTS
========
 0. WHAT'S NEW
 1. GAME FEATURES
 2. THE GAME
 3. TO PLAY
 4. INSTALLATION
 5. DISCLAIMER
 6. REGISTRATION INFORMATION
 7. DISTRIBUTION
 8. SHAREWARE AGREEMENT
 9. LICENSING AGREEMENT
10. HISTORY
11. PROBLEM ?



0. WHAT'S NEW
   ==========
   Version 1.9
   - Has three different tiles layout. User selectable or let
     PalmPilot select one for you for each new game.
   - Game engine is now more generic and uses less memory stack
     area. This is to enable support for different tiles layout.
     It now handles low stack memory better, especially 
     for PalmPilot OS 1.x. This also resulted in a slightly 
     slower game generator.
   - Revised Gane statistics. It now keep tracks only of game won
     and lost for each of the board style and a total for all.


1. GAME FEATURES
   =============
   - Three different tiles layout.
   - All solvable puzzle generator. All puzzle has at least a solution.
   - Ability to show a sample solution for the current puzzle.
   - User selectable tile font size.
   - Dynamic tile resizing to fit screen size for easy viewing.
   - Selectable game number. You can replay the game again as
     and when you want to.
   - Hint features to show you selectable tiles.
   - Find match feature show you the matching tiles you have
     selected. All matching tiles will be shown in sequence.
   - Find visible and find all.
   - User selectable double tap on tile for find match. Simplified
     the search for matching tile.
   - Full undo ability. You can undo till start of game.
   - Random Play feature, where the computer will quickly play
     the game by selecting selectable tiles in a random manner.
   - Memorized and recall game state.
   - Tile statistics.
   - Statistics of game won and lost.


2. THE GAME
   ========
   PalmJongg is a simple game of matching tiles. It is played using
   mahjongg tiles. You can remove tiles by selecting two similar
   tiles.

   You can only select the right or left most tiles, and if it is
   not stacked by other tile.


3. TO PLAY
   =======
   Select one selectable tile and select the matching tile to remove it.
   Selectable tile will be highlighted. To unselect, either tap outside 
   the tiles area or tap another non matching selectable tile.

   If double tab find match is enabled, you can find matching tiles of
   the current selected tiles easily by tapping the same tile again.
   Matching tiles of the current selected tiles will be highlighted.

   Matching tiles are tiles of the same pattern and value. The only 
   exception is for the following tiles :
   1. Season tiles can match each other. They are mark as SU,SP,WI and AU.
   2. Cross tiles can match each other. They are mark as CR.

   The MENU commands are as follows :

   COMMANDS
   ~~~~~~~~
   - NEW GAME     : Play the next new game.

   - RESTART GAME : Restart the current game.

   - SELECT GAME  : Select a specific game to play.

   - PREFERENCES  : Game settings.
                    DOUBLE TAP AS FIND ...
                    - NONE   : No action.
                    - MATCH  : Tapping the same selected tile is doing a
                               Find Match.
                    - VISIBLE: Tapping the same selected tile is doing a
                               Find Visible.
                    - ALL    : Tapping the same selected tile is doing a
                               Find All.

                    GREY BACKGROUND
                    - The board background is grey.
             
                    LARGER FONT
                    - Use a larger font on tile.

                    RANDOM GAME ORDER
                    - Each new game is in random order.

                    SLOW AUTO MODE
                    - Slowdown to enable you to see easily the move during
                      Random Play, Show Solution and Demo.


   - GAME STATS.  : Show the game statistics. You will be shown the
                    number of game you have won, and lost.

                    Game won details percentage is based on the total game 
                    won. Assisted game is where the the hint, find match, 
                    undo or quick play feature has been used.

                    You can reset the score by pressing the RESET button.

   - FIND MATCH   : Find a matching tiles to the currently selected tile.
                    The matching tile can be selected legally.

   - FIND VISIBLE : Find all visible tiles similar to the currently selected
                    tile.

   - FIND ALL     : Find all tiles similar to the currently selected tile.

   - HINT         : Show a valid matching tiles that you can remove.

   - UNDO         : Undo the last move.

   - RANDOM PLAY  : Randomly select valid tiles to remove.

   - SHOW SOLUTION: Show a sample solution for the current puzzle.

   - MEMORIZED    : Memorized the current game state. A M+ indicator will
                    be shown on the bottom right corner.

   - RECALL       : Recall the memorized game state.

                    Note: The memorized state will be lost when the game is
                          restarted or a new game is started.

   - TILE STATS.  : Show the count for each of the different tiles that are
                    still remaining on the board. If the tile is no longer
                    on the board, it will not be shown.


   HELP
   ~~~~
   - RULES   : Text about the game play.
   - ABOUT   : Author information.


4. INSTALLATION
   ============
   Install pjongg.prc using the standard pilot application installer.


5. DISCLAIMER
   ==========
   The author will not take responsibility for any form of damage or loss 
   that occurs when/by using this program. By using the program, you have 
   agreed on all the conditions stated here.



6. REGISTRATION INFORMATION
   ========================
   For registration information, please read the REGISTER.TXT file.


7. DISTRIBUTION
   ============
   This manual and all accompanying files may be distributed freely,
   provided that:
   - Neither text nor any other file is modified in any way. No file
     may be omitted nor added in the distribution.

   - No money may be charged for the program nor for any accompanying
     files, other than the usual downloading time fees charged by
     commercial BBSes and online services.

   - I want to know where my program will be distributed. Please notify me
     if it will be included in printed matter, floppy, or CD-ROM before its
     publication. No matter what the circumstance, I would strongly
     appreciate a copy of whatever collection in which it is included.



8. SHAREWARE AGREEMENT
   ===================
   PalmJongg is a ShareWare. After registration, you are licence to use it. 
   All ownership and Copyright of the software belongs to Tan Kok Mun. 
   Please read LICENSING AGREEMENT below. Each registered copy can only
   be used in a single machine.


   
9. LICENSING AGREEMENT
   ===================
   The software accompanying this document (the Software) and the related  
   documentation are licensed to you by Tan Kok Mun (the author) after the
   registration or during the trial period of the first 30 usage from the 
   date of installation.
   
   The software contains copyrighted material and other proprietary material. 


10.HISTORY
   =======
   20/02/1998 - Version 1.9

   02/01/1998 - Version 1.8 
              - Game generator is now 50% faster.
              - Find visible.
              - Find all.
              - Memorized and recall game state. Uses only 4 additional 
                bytes to save the current tile status.
              - Tile statistics.
              - Menu has been reaaranged and some of the shortcut changed.
              - Demo mode has been removed to save memory.
              - Help-tile has been merged with tile statistics.
              - Fixed screen update problem for Palm OS 1.x.

   26/12/1997 - Version 1.6 - Unreleased.

   19/12/1997 - Version 1.5
              - All solvable puzzle generator. All puzzle has at least
                a solution.
              - Rename of Quick Play to Random Play to reduce confusion.
              - Ability to show a sample solution for the current puzzle.
              - User selectable tile font size.
              - User selectable slow auto mode. This will slowdown the
                animation to enable you to see easily the move during
                Random Play, Show Solution and Demo.
              - User preferences are effective immediately.
              - Demo mode.
              - Valid moves indicator.

   29/11/1997 - Version 1.0


11.PROBLEM ?
   =========
   If you wish to contact me, I can be reached at:

        E-Mail   : kokmun@pacific.net.sg
        Web Page : http://home.pacific.net.sg/~kokmun/
