=============================================================================
Hangman - Desktop Word Game                                      Version 1.12

(c) Stephen Fryatt, 1996-2020                               23 September 2020
=============================================================================


Licence
-------

  Hangman is licensed under the EUPL, Version 1.2 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 Hangman 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
------------

  Hangman is a desktop implementation of the traditional word-guessing game.
  At the start of their turn, the player is presented with a random word in
  which all the letters have been replaced by dashes.  Attempts must be made
  to guess the letters: if a guess is correct then that letter is shown in
  all its locations, but if wrong a 'life' is lost.  If the whole word has
  been guessed before all the available lives have gone, the player has won.



Installing Hangman
------------------

  To install Hangman on a hard disc, copy the !Hangman application to a
  suitable place on the disc.

  Hangman requires Computer Concepts' Impression Spell module to be loaded
  before it will run.  If you don't already have a copy suitable for your
  system, a 32-bit version can be found in the OMAP distributions of the Zap
  text editor at http://www.tankstage.co.uk/software.html.



Using Hangman
-------------

  Once installed, double-click on !Hangman to open the game window; ensure
  that the game has input focus by clicking within the window if necessary.
  At the top of the window a row of light blue dashes indicates the word to
  be guessed, while below these are a row of dark blue blocks which show how
  many guesses are left.

  To guess a letter, press the key on the keyboard.  If the letter is correct
  it will be placed in position in the word; the last letter entered is
  highlighted in red.  If the letter is wrong, one chance will be lost and
  the letter will be shown in the small box to the bottom-left of the window.

  If the word is correctly guessed within the required number of tries, then
  the letters will turn blue to show this.  If the chances run out or the
  player resigns (by clicking on the 'Resign' icon or pressing Return) then
  the missing letters will be filled in in green.

  To start a new word, click on the 'New Word' icon or press Return once the
  game has ended.



Game Options
------------

  Selecting 'Options...' from the hangman window menu will open the hangman
  options dialogue.

  The 'Minimum word lenth' and 'Maximum word length' fields set the range of
  word lengths which will be selected by the game: if these are set too high,
  then the range of words available will be limited.  Note that it is not
  possible to set the minimum field to more than the maximum, or vice-versa:
  it might be necessary to adjust the two fields in turn to avoid a conflict.

  'Number of guesses' sets the number of incorrect guesses that the game will
  allow.

  Once set, click on 'OK' to set the new values or 'Cancel' to forget any
  changes made.  The values here will only persist until the main hangman
  window is closed.



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

  The following versions of Hangman have been available.


  1.00 (19 June 2002)
  -------------------

  The original public release of Hangman.


  1.10 (6 September 2014)
  -----------------------

  Second stable release; re-licensed under the EUPL.

  * 'Help' menu item and 'Website' button added to application.
  * Support for Interactive Help added.
  * Randomly seed "RND()" from OS timer when Hangman loads, to provide some
    variation in word selection (Ticket #493).


  1.11 (5 March 2017)
  -------------------

  Update to second stable release.

  * Fix !Help so that 'Help' menu items work correctly.


  1.12 (23 September 2020)
  ------------------------

  Update to second stable release.

  * Licence updated to EUPL v1.2.
  * Use ResConf-style system variables to identify resources.



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

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

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

  Stephen Fryatt
  email: info@stevefryatt.org.uk
