]> git.saurik.com Git - wxWidgets.git/blob - demos/bombs/readme.txt
Added useful comment
[wxWidgets.git] / demos / 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 successfully 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++.