HangMan 1.0b3 (C) TanKM 1996
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. INTRODUCTION
~~~~~~~~~~~~~~~
HangMan is a simple word guessing game. You guess the word by specifying
individual character. When you guessed the right character the location
of the character is shown. Initially the game is purely luck, but as you
guess some right characters, your skill in English will be most useful.
To help you out and to reduce some elements of luck, the first character
of the word is always displayed, and this character is still a valid 
character for you to use.

If you guess the wrong character, the error count will be increased and 
you can make up to a maximum of 8 wrong guesses and you lost the game.

The HangMan has a dictionary of 540+ words.


2. INSTALLATION
~~~~~~~~~~~~~~~
There is two files for HangMan, one is the BASIC source and the second is 
the HangMan dictionary.
   
  HANGMAN.CSV - The HangMan dictionary file. This file is in PILOT MEMO
                CSV format. To install this file follow the following
                steps :

                1. Startup your PILOT DESKTOP.

                2. Select MEMO, than FILE and finally IMPORT. When prompted
                for filename, enter the HANGMAN.CSV. Uncheck the PRIVATE
                option in the PILOT FIELDS as well. Due to the limitation of
                the PILOT IMPORT facility, the memo after importing will be
                in two seperate memo in MEMOPAD. The first is "!!HM" and the
                second is "thick". These two memo need to be merged as one.
                If you do not merge it correctly, HANGMAN may not run
                correctly.

                3. Still at your PILOT DESKTOP. Select "thick" memo. Click
                on the content on the right. Do a EDIT-SELECT ALL and COPY.
                Now select "!!HM" memo, on the right, go to the bottom of
                the memo, the last line should be "these", move the cursor
                below "these", now do a EDIT-PASTE. The HANGMAN DICTIONARY
                is now merged and will be in your pilot at the next HOTSYNC.

                It can be in any of your MEMOPAD category. I recommend that
                you use the MEMOSORT or SUPERPAD utility to automatically
                sort your memo documents. This will move the memo to
                beginning of the memo chain. This will help speed up the
                HANGMAN initialisation time. Please ensure the first line
                of this file in your MEMOPAD is "!!HM".

                If the dictionary is not installed properly, when you run
                HangMan, you will not get any response for a long time and 
                eventually it will end, and you are back to the cBasPad 
                file selection menu. 

                WARNING: Do not modify this file to include your own words, in it.
                There is a companion setup program and some tailoring that need to
                be done when this file is modified.

                The companion program is in the package but no documentation yet.


2. TO PLAY
~~~~~~~~~~
To start HangMan, start cbasPad, select HangMan and run it by
selecting "EXEC".

Once the PILOT is ready, you will be presented with a screen similar to 
the following :

    Word h****.........  <<--- Hint for the word, one * for each character.
  Errors 0 of 8........  <<--- Errors guesses you have made.
 History ..............  <<--- History of the character you have used.
         ..............
 Guess ? ..............  <<--- Your guess.
         ..............
         ..............
         ..............
         ..............

 <OK>  <Cancel>  <A> <B>

The Buttons have the following usage :
<OK>        - You have entered your guess and ask the PILOT to process it.
<CANCEL>    - You want to end current game.
<A> and <B> - Same as <OK>.

When you press "<OK>", the PILOT will analyse your guess and shows you
hints on your guess. The location of the correct character will be shown, 
replacing the "*". 

If the "Guess ?" input is not empty, after you press "<OK>", this shows 
that your guess is not valid. Invalid guess includes :
   - The character is not in lower case or not an alpha character, 
     only a..z are valid characters.
   - The character has been used. Please check history.

When you have correctly guessed the word, you will end the current game 
and the message "You Got It" will be displayed. At this point, if you want 
to play another game, press <OK>, or to end HangMan, press <CANCEL>.

You are only allowed to made 8 wrong guesses. When you made 8 wrong guesses
you lost and the message "Too Bad" will be displayed. At this point, if you 
want to play another game, press <OK>, or to end HangMan, press <CANCEL>.
