=============================================================================
Decode - Guess the hidden sequences                              Version 1.02

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

  This file is also contained within the Decode application and can be
  accessed from 'Help' on the Decode iconbar menu and from the 'Help' entry
  in the Filer menu.



Licence
-------

  Decode 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 Decode 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



Installing Decode
-----------------

  Decode requires RISC OS 3.1 or later, and can be run off a hard disc or
  floppy disc.  To install Decode on a hard disc, copy the !Decode
  application to a suitable place on your disc.



Using Decode
------------

  The aim of Decode is to guess a sequence of four colours selected randomly
  by the computer.  Load it on to the iconbar in the usual way and click
  Select on its icon to open the game window.

  Sequences always contain four different coloured pegs from the row of ten
  at the top of the window: no colour will be used more than once.  Up to
  twelve guesses can be made and after each, the computer will score the
  guess to show how close it is to the correct answer.  Using this
  information, it should be possible to identify the chosen sequence.

  Starting with row 1, whose number will be highlighted in red, drag pegs
  from the row at the top of the window to the four larger holes on the left.
  Pegs already in the row can be dragged to move them around: the rows below
  can be used as 'scratch space' if required.  To lose a peg completely, drop
  it away from a hole.

  Once the row is complete and able to be scored, a '?' button appears to its
  right: click on this, and the computer will mark the guess.  Marks are
  given using the smaller holes on the right: a black peg indicates a correct
  colour that is in the correct position in the row, while a white peg
  indicates a correct colour that is in the wrong position.  The order of the
  black and white pegs has no significance.

  Unless you strike lucky with four black pegs on the first attempt, the game
  moves on to row 2 and the process repeats until the correct sequence is
  found (or all twelve rows are used).  After the first row, pegs can also be
  dragged in from previous guesses in the rows above.

  Once you have guessed the code or run out of attempts (or just got bored of
  the current sequence), click Menu over the main window and select 'New
  Game'.

  The 'Solid Drags' option in the iconbar menu alternates between dragging
  sprites and dotted boxes; there is rarely any need to turn this option off.



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

  Here is a list of the versions of Decode, along with all the changes made.


  0.10 (19 June 2002)
  -------------------

  First stable release.


  1.00 (24 September 2014)
  ------------------------

  Second stable release.

  * Build system revised and license updated to EUPL.
  * 'Help' menu entry added to iconbar menu.
  * 'Website' button added to program information window.
  * Menus remain open when selections are made with Adjust.
  * Add support for Interactive Help.
  * Restructured user interface, removing 'Score' and 'New' buttons and
    implementing main window menu.


  1.01 (5 March 2017)
  -------------------

  Update to second stable release.

  * Fix !Help so that 'Help' menu items work correctly.
  * Tidy up Wimp message handling code.


  1.02 (23 September 2020)
  ------------------------

  Update to second stable release.

  * Licence updated to EUPL v1.2.
  * Use ResConf-style system variables to identify resources.
  * Renamed application following official allocation request.



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

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

  Updates to Decode 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
