Overview
--------
The Boggle computer game is based on the board game of the same name.  The 
game consists of a game board,  16 dice, and a timer.  The object of the 
game is to roll the dice and create as many words as possible using the 
letters that show up on the die face. The words have to be at least three 
letters in length and the letters that you choose have to be adjacent to each 
other.

The computer game has a built in dictionary with 29956 words 
in it.  After the game has ended,  you may choose options/Find 
all and the computer will list every word that it found based
on this dictionary.  The words that you found are hilighted in 
the word list list box as well.

Sound is provided via the OS/2 multimedia classes.  You will 
notice that different sounds are played when correct words are moved 
to the word list,  words greater than four characters in length 
are formed,  incorrect words are formed,  and when the timer 
increments itself during game play.

My kids enjoy the game and actually learn how to spell and form
new words in the process.  It is released as shareware and I hope
you will enjoy it.

This game was developed using OS/2 Visual C++ compiler and the OpenClass 
class libraries.  


Starting the game
------------------
1. Unzip the file called BOGGLE.ZIP into the directory of your choice.  This 
will create the necessary game files and a file called SOURCE.ZIP.  This file 
contains the source code needed to compile the game.

2. To begin the game,  type "boggle" at the command prompt.  When the game 
begins,  click on file/new to start a new game.  If sound is not desired or 
you wish to change the timer length,  choose options/settings first.



Playing the game 
------------------
1. Click on a letter with the left mouse button and the letter will be 
hilighted and copied to the word in progress edit field.  Click on adjacent 
letters to form words in the word in progress edit field.  When a completed 
word is  formed,  click with the right mouse button.  The word will be 
validated against the dictionary and the scoring will be determined.  If the 
word was valid,  it will be moved to the word list box on the right hand side 
of the screen.


You can also hold down the left mouse button and form words by dragging the 
mouse over the desired letters.  If the word you form is not valid,  you can 
clear it and start again by right clicking on any of the letters.  For more 
details,  refer to the on-line help.


Note
------
The system sounds might be disabled if you are currently running any 
DOS/Windows applications.  I found that on my machine if I simply closed the 
DOS-based application,  the sound worked just fine.


Compiling the Source Code 
------------------------- 
The reason for submitting the source code was to 
provide more examples of using the IBM Class libraries for real-world 
applications.  I hope you find some useful examples of how to use the class 
libraries.  Maybe this will help spur other application development.

To compile the source,  unzip the SOURCE.ZIP file into the desired 
subdirectory and type "nmake /f boggle.mak" at the command prompt.


Registration
------------
This product is released as Shareware.  If you like the product,  please 
register with the author by sending $5.00 to:

David Boudah
180 Cottage Road
Enfield, CT 06082
Compuserve ID -73163,3657
InterNet - dboudah@ibm.net