
HungMan  Version 1.06
Written February, 2000 by Jim Knopf, aka Jim Button.
http://home.earthlink.net/~jimknopf/

This is totally free software.
No cost. No guilt. No support.

SYNOPSIS: Play the game of Hangman with your Palm Pilot. Use the word lists that
appeal to you, or make your own word lists. A fun and educational game, with word lists for U.S. presidents,
state capitols, college teams, Bible books, professional golfers, baby names, 
computer terms, Pokemon characters, automobiles, animals, countries, and Harry Potter.

To INSTALL:
Hot-Sync the following files into your Palm Pilot:
 HungMan.prc
 Hungload.prc (only if you intend to create your own word lists).
One or more of the following Hung_.pdb files must be used. These files
are the word lists you can play against.
 Hung1.pdb State Capitols  
 Hung2.pdb U.S. Presidents
 Hung3.pdb College team names
 Hung4.pdb Books of the Bible
 Hung5.pdb Professional Golfers
 Hung6.pdb Top 200 Baby names
 Hung7.pdb Top 100 Athletes of the centure (ESPN)
 Hung8.pdb Pokemon characters (163)
 Hung9.pdb Computer terms (127)
 Hung10.pdb Automobile makes (81)
 Hung11.pdb Animal kingdom
 Hung12.pdb Countries
 Hung13.pdb Harry Potter
PocketC.prc (Only needed if you don't already have it on your Palm Pilot.)
   This is the run-time version. Do NOT put it on if you are a programmer
   who uses the PocketC compiler.
   
To PLAY:
 When you start Hungman, the first word list found will be used.
 Pick letters from the letter boxes. If your guess is correct, the
 letter will be filled in on the answer. If incorrect, a part of the
 hungman will be drawn. You will be allowed to make 6 incorrect guesses,
 but on the seventh error you will lose the game.
NEW: This button starts a new game. A new word will be selected from the
 current word list.
CHANGE: Changes to the next word list and picks a new word.
SHOW: If you give up, this will show you the answer.
QUIT: Quits Hungman.

CREATING WORD LISTS:
 The program "Hungload.prc" allows you to create your own word lists. To do this,
 create a memo file with all the words to be included in the list. NOTE: The top line of the
 memo file must be a single line with only the word "Hung".
 When you run Hungload, it will ask you for a TITLE for your word list, and for a NUMBER
 for your word list. If you use the number of a word list that already exists, it will
 confirm your request. 
   Here is an example word list:
     Hung
     MATTHEW
     MARK
     LUKE
     JOHN
     (REVELATION) The last book of the New Testament.
     ROMANS
 The longer line above shows how to put a word into the list with "teaching text" that will be
 displayed after the word is solved.
 After your new word list (.pdb file) is created, you may delete the memo used to create
 the list.
 If you create a word list that you think should be shared with others, please send it in.


REMOVING WORD LISTS:
To remove any of the word lists, do the following:
1. Start the program called "PocketC".
2. Tap the Menu icon at the bottom of the screen.
3. Under "Applet", click "Databases".
4. Highlight the word list to be deleted.
   It will be called something "Hung1" or "Hung2".
   (Check the "readme" file to determine which list to delete.)
5. Tap the "Delete" button at the bottom of the window.
Make sure that you keep at least one word list on the Palm.

RESETTING YOUR SCORE HISTORY TO ZEROS:
Follow the steps above under "REMOVING WORD LISTS", except delete the
database called "Hung".

Version summary:
  1.06 11/03/00 Added program "Hungload" for creating word lists.
  1.05 4/08/00 Allow teaching text in the word lists, and therefore enhanced
               hung1, hung2, hung3, hung5, and hung7.
  1.04 3/??/00 Allow up to 20 different word lists.
  1.03 3/10/00 Fixed a scoring bug.
  1.02 3/08/00 Added statistics.
  1.01 3/03/00 Improved to handle embedded special characters in words.
               Added more word lists.
  1.00 3/01/00 Initial release.

LEGAL:
------
This software is provided as is, with no guarantee of fitness for any particular
task. The user assumes all responsibility for its use.

You can always download the current version here:
http://home.earthlink.net/~jimknopf/

I hope you enjoy Hungman. I would love to hear from you. 
Let me know what your favorite word lists are, or what you would like to have.
Please send comments and suggestions to:
   ki7q@arrl.net

-Jim Knopf, aka Jim Button
