samples/bombs/readme.txt

   1                     wxWin Bombs
   2                  by Pasquale Foggia
   3
   4 1. The aim of the program
   5 wxWin Bombs is the wxWin implementation of the minesweeper game you find
   6 under MSWindows 3.1+. Later the rules of the game will be explained for
   7 the lucky ones of you that have never used Windows.
   8
   9 2. Installation
  10 If you are reading this file, I suppose you have succesfully unpacked the
  11 files in a directory of your hard disk :-). You should already have
  12 installed wxWin on your system.
  13 Now you have to modify makefile.bcc
  14 (if a Windows user) or makefile.unx (if you use a real OS) setting the
  15 proper values for the directories. Finally, you have to run:
  16   make -f makefile.bcc
  17 for Windows (nmake if you use a MicroSoft compiler), or:
  18   make -f makefile.unx xview
  19 for Unix+xview and
  20   make -f makefile.unx motif
  21 for Unix+motif
  22
  23 If you are lucky, you will find the bombs executable, ready to be run.
  24
  25 3. Test
  26 Bombs has been tested under the following platforms:
  27   PC + MSWindos 3.1 + wxWin 1.60 + Borland C 3.1
  28   Sun SPARCstation 20 + SunOS + xview + wxWin 1.63 + gcc 2.3.3
  29 and all seems to work fine.
  30
  31 4. The author
  32 This program has been developed by Pasquale Foggia, a PhD student
  33 in Computer Engineering at the "Federico II" University of Naples, Italy.
  34 You can contacting him using the following address:
  35   foggia@amalfi.dis.unina.it
  36
  37 5. Disclaimer
  38 This program is freeware. You can do everything you want with it, including
  39 copying and modifying, without the need of a permission from the author.
  40 On the other hand, this program is provided AS IS, with NO KIND OF WARRANTY.
  41 The author will be in NO CASE responsible for damages directly or indirectly
  42 caused by this program. Use it AT YOUR OWN RISK, or don't use it at all.
  43
  44 6. The rules of the game
  45 Your aim is to discover all the bombs in a mined field. If you click with
  46 the left mouse button on a cell containing a bomb, your game ends.
  47 Otherwise, the number of bombs in the 8 neighbour cells will be displayed.
  48 When you have clicked all the cells without a bomb, you win.
  49 You can also use the right button (or left button+shift) to mark a cell
  50 you think hides a bomb, in order to not click it accidentally.
  51
  52 7. Concluding remarks
  53 I hope someone of you will enjoy this program. However, I enjoyed writing
  54 it (thanks to Julian Smart and all the other wxWin developers).
  55 In the near future I plan to implement under wxWin the great 'empire'
  56 (is there someone that still remember it?), IMHO one of the most addictive
  57 strategy games. If someone is interested, please contact me by e-mail.
  58 I beg you pardon for my approximative english.
  59
  60                                                 Pasquale Foggia
  61                                                 foggia@amalfi.dis.unina.it
  62
  63
  64 ------
  65 A note from Julian Smart: Many thanks to Pasquale for the contribution.
  66 I've taken the liberty of making a few changes.
  67
  68 1) I've made the status line have a single field so that you
  69 can see the 'cells remaining' message properly.
  70
  71 2) I've changed the title from "wxWin Bombs" (which, as a statement,
  72 is an unfortunate reflection of the reality of earlier versions of
  73 wxWindows :-)) to wxBombs.
  74
  75 3) Added SetClientData to resize the window on Restart; eliminated
  76 scrollbars; made the frame unresizeable.
  77
  78 4) Added makefile.dos for VC++ 1.x, makefile.wat for Watcom C++.