name:   Sweeper
author: Eli-Jean R. Leyssens (pervect@topix.student.utwente.nl)
size:   1024 bytes (YEAH! ;)
needs:  Arm2 + MODE13 capable monitor + RISCOS 3 (Non-squashed version runs
        on RISCOS 2)
descr.: MODE 13 version of the (by now) classic minesweeper
-----------------------------------------------------------------------------

  To start the game, just double-click the Sweeper file. This will switch the
display into MODE 13, so make sure your monitor can display it. You can then
start playing the game.

  Object of the game is to locate all mines hidden in the playing field and
uncover all the other fields. The game ends either when you uncover a field
that contains a mine, in which case you lose the game, or when you've
uncovered all fields that do not contain mines, in which case you win the
game. The second objective is your score, which is really only the number of
seconds you have taken to complete the game. The faster you complete a game,
the better your score (albeit a lower number ;)
 
  How to play the game?   First of all, the game has three difficulty
settings:

  Difficulty      Width    Height    Mines     Density (mines per field)
  
  Beginner            8         8       10        0.16
  Intermediate       16        16       40        0.16
  Expert             30        16       99        0.21

  You can choose one of the above difficulty settings by clicking on either
the B, I or E located at the top of the screen. Note that clicking one of
these will abort any game that might be in progress and will start a new
game. Also, if you've lost or won a game you will have to click one of the
above to start a new game.

  The number in the upperleft corner indicates how many mines you have not
yet marked. If this is a negative number then you have marked more mines than
the actual number of mines contained in the field. Obviously you will then
have to unmark some, what you thought were, mines.
  The number in the upperright corner indicates the number of seconds since
you started playing the current field. When you start a new game the seconds
will start counting as soon as you mark or uncover one of the fields.

  The most important thing, marking and uncovering fields. When you
uncover a field there are three things that can happen:
  - the field contains a mine and you loose the game. The program will then
    uncover all fields and show you where all the mines were.    

  - the field contains no mine, but at least one of the eight adjecting
    fields does. The uncovered field will show a number indicating the number
    of adjecting fields containing a mine.

  - the field contains no mine, and none of its eight adjecting fields
    contains a mine either. In this case the program will automatically
    uncover all the eight adjecting fields too. But what's even more! for
    every uncovered adjecting field the same check is performed as above.
    This way a whole area of fields will be uncovered.
    Note: if you marked a field as a mine or 'uncertain' then that field
    will never be opened automatically by this process, even if it does not
    contain a mine.
    
  How to mark and uncover fields: just move the mouse pointer to one of the
fields and then click with one of the mouse buttons:
  
  Button      Action
  
  Select      Uncover field. If it contains a mine you lose the game.
  Menu        Mark as 'uncertain'. If the field was already marked as
              uncertain then the field will be unmarked.
  Adjust      Mark as 'mine'. If the field was already marked as a mine then
              the field will be unmarked.


 
  Files included in this archive are:
Sweeper           ; The program itself
ReadMe            ; This file
More.!SetPaths    ; Sets the SweeperWork$Dir
More.!Squash      ; Squashes the SweeperSRX file
More.Build        ; Build instructions (Sources->Final)
More.SweeperSRC   ; Source code


  Thanx go to Mohsen Alshayef for his excellent !StrongBS and to Alain
Brobecker for organising CodeCraft, the 1K/4K coding competition.
  
  If you want to contact me or want to know more about Topix or Topix
productions:

    Pervect :     pervect@topix.student.utwente.nl

    TopixWEB:     http://www.dse.nl/~topix
