=============================================================
= THE FORTUNE PROGRAM DOCUMENTATION                         =
=                                                           =
= Written by Raymond Vrolijk                                =
=                                                           =
= Official RVT documentation for the 'fortune' application  =
= which is part of the RVT Desktop			    =
=============================================================


WHY FORTUNE?
============
When I was using Slackware Linux the first time, I saw a nice
message (a fortune cookie) on my console. I found out that it
came from the fortune binary in /usr/games ...

On a boring night (yeah coders don't sleep :P) I remembered
the nice fortune cookies which always appeared on my Linux
screen (yeah crontab rules :P) and I wrote a rip-off for MS-DOS.
I also found some computer jokes on the Programmer's Heaven CD
(www.programmersheaven.com) and ported the .txt file to a format
which was readable by both Linux fortune and my own fortune program.
The RVT fortune application was born...


USAGE
=====
Just go to the RVT Desktop main directory and load fortune.exe
It sends a fortune cookie to stdout, so you can redirect it to
any DOS device you want (e.g to LPT1).


HOW DOES IT WORK?
=================
It reads the file called 'fortunes' in the RVT main directory
and chooses a random cookie.


KNOWN BUGS
==========
There is 1 bug in my fortune application. When you add the '%'
character to the fortunes file (the file with the fortune cookies)
it doesn't see that the file is at EOF so it tries to read behind
the end of the file and it prints out an error to stdout and
returns to DOS with exitcode 666.

The situation is outlined below:

               % <- fortune seperator
               last fortune of the file
               % <- fortune seperator
               END OF FILE

We recommend you to remove the '%' character at the end of the file
(if it isn't removed yet) and the bug is fixed...


AUTHOR
======
Raymond Vrolijk ( raymond@webslice.nl )
