=============================================================================
Fortune - Display a random fortune with the welcome banner       Version 1.20

(C) Stephen Fryatt, 1997-2014                                 2 February 2014
=============================================================================


Licence
-------

  Fortune is licensed under the EUPL, Version 1.1 only (the "Licence"); you
  may not use this work except in compliance with the Licence.

  You may obtain a copy of the Licence at
  http://joinup.ec.europa.eu/software/page/eupl

  Unless required by applicable law or agreed to in writing, software
  distributed under the Licence is distributed on an "AS IS" basis, WITHOUT
  WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

  See the Licence for the specific language governing permissions and
  limitations under the Licence.

  The source for Fortune can be found alongside this binary download, at
  http://www.stevefryatt.org.uk/software

  The necessary libraries and build tools can be found at
  http://www.stevefryatt.org.uk/software/build



Introduction
------------

  Fortune is a small module to display a random fortune when the Desktop
  starts up, under the welcome banner.  It should work on any version of
  RISC OS from 3.1 onwards.  The module is 26/32 bit neutral and should work
  on RISC OS 5.



Installing Fortune
------------------

  To install Fortune on a system with the new !Boot structure, copy the
  Fortune directory from this archive into Choices:Boot.PreDesk.

  You will need to provide a file of fortunes for the module to use: these
  are in the form of a text file containing one fortune per line, with a
  carriage return (ASCII 10, the standard for normal RISC OS text files)
  between each one.  Files like this are freely available on the Internet.
  Copy the file into the Fortune directory (a dummy file called Fortunes has
  been supplied with some rather silly lines in it).

  Load the Fortune.!Run file into a text editor.  There is one line that
  needs to be edited for your specific fortunes file:

    Set Welcome$FortuneFile <Obey$Dir>.Fortunes

  where the "Fortunes" at the end should be changed to the name of the text
  file you have supplied.  See the comments in the file for more details.

  If you are not using the new !Boot you must ensure that the Fortunes module
  is loaded and the two system variables are set up before the Desktop is
  entered.  How this is achieved depends on how your boot sequence has been
  built.



Version History
---------------

  The following is a list of all the versions of Fortune.


  1.00 (17 June 1997)
  -------------------

  * First version.


  1.02 (16 September 2001)
  ------------------------

  * Initial public release version.


  1.10 (6 December 2002)
  ----------------------

  Public Beta release.

  * Module converted to new format and checked for 32-bit compatibility.


  1.20 (2 February 2014)
  ----------------------

  * Converted source to ObjAsm format and checked for ARMv7 compatibility.
  * Count fortunes in file on loading, to avoid the need to set
    "<Welcome$Fortunes>" to the correct value (modification supplied by
    Martin Bazley).
  * Ensure that "OS_Find 0" is always called with a valid file handle (fix
    supplied by Martin Bazley).



Updates and Contacting Me
-------------------------

  If you have any comments about Fortune, or would like to report any
  bugs that you find, you can email me at the address below.

  Updates to Fortune and more programs for RISC OS computers can be
  found on my website at http://www.stevefryatt.org.uk/software/

  Stephen Fryatt
  email: steve@stevefryatt.org.uk
