
                  Yawn 1.0 - A demo for the TDice component
                  -----------------------------------------
                    Copyright (c) 1995 Alessandro Scotti
                        E-mail: a.scotti@agora.stm.it


  This little program is yet another version of the popular "Yathzee" game. I
wrote the program just to find a use for the TDice component (which in turn
was intended as an example about writing Delphi components for a friend of
mine) but the game turns out to be quite enjoyable.

  To compile the program you have to install the dice component first:
Options/Install components/Add/Browse and select DICE.PAS. After the library
has been rebuilt you can open the YAWN project and compile as usual. I've not
included the compiled program because the archive is much smaller without.

  I won't explain the rules of the game, but they are very simple and every
button has a tooltip which will help you a little in case you are a beginner.
By the way it's called "Yawn" because most of it has been coded quite late at
night, so you'll excuse me if somewhere the code leaves something to be
desired...

  Maybe you'll find useful two little "tricks" I have used in the program, see
the BOSSTOOL unit and the WndProc function in MAINFORM. Quite simply, when the
"Boss" key is pressed, the bossEnter function uses some Window APIs to change
the caption and icon of the window so that it looks like the "Calculator"
program when minimized. Nice and possibly useful. Also, because I like the 3D
look given to resizeable windows in Win95, the border of the main form is set
to "sizeable" but then the WM_NCHITTEST is trapped so that sizing is not
allowed at runtime (a dialog border would hide the form icon and minimize
button). To make things better, the WM_INITMENU message is also trapped and
the "Size" item in the system menu is grayed.

  Multi-line hints are very simple too, just take a look at the DoShowHint
method in the main form. It translates the '@' character into a CRLF
sequence, then Delphi does all the work.

  Well, that's it... have fun!

Oh... I was almost forgetting... all the code in the "Yawn" project is
freeware: do whatever you want with it, but do it at your own risk! Please
read the warranty disclaimer below before using the code.

Warranty disclaimer
-------------------

BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO
WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE
LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT
WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT
NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS TO THE
QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
SERVICING, REPAIR OR CORRECTION.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE
LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU
OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY
OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

