1Dies ist moon-buggy.info, hergestellt von Makeinfo Version 4.7 aus
2moon-buggy.texi.
3
4INFO-DIR-SECTION Games
5START-INFO-DIR-ENTRY
6* moon-buggy: (moon-buggy).     Drive some car across the moon
7END-INFO-DIR-ENTRY
8
9   This file documents moon-buggy, a simple character graphics game.
10
11   Copyright 1999, 2000 Jochen Voss
12
13   Permission is granted to make and distribute verbatim copies of this
14manual provided the copyright notice and this permission notice are
15preserved on all copies.
16
17   Permission is granted to copy and distribute modified versions of
18this manual under the conditions for verbatim copying, provided that the
19entire resulting derived work is distributed under the terms of a
20permission notice identical to this one.
21
22   Permission is granted to copy and distribute translations of this
23manual into another language, under the above conditions for modified
24versions, except that this permission notice may be stated in a
25translation approved by the Free Software Foundation.
26
27
28File: moon-buggy.info,  Node: Top,  Next: Introduction,  Prev: (dir),  Up: (dir)
29
30   Moon-buggy is a simple character graphics game, where you drive some
31kind of car across the moon's surface.  Unfortunately there are
32dangerous craters there.  Fortunately your car can jump over them!
33
34   This edition (last updated 27 December 2004) of the manual applies to
35version 1.0.51 of the program.
36
37* Menu:
38
39* Introduction::                Introduction
40* Moon-buggy Invocation::       Moon-buggy Invocation
41* Playing the Game::            Keyboard commands
42* Shared Score Files::          Competition via the highscore table
43* Installation::                Installation and setup
44* References::                  References
45
46
47File: moon-buggy.info,  Node: Introduction,  Next: Moon-buggy Invocation,  Prev: Top,  Up: Top
48
491 Introduction
50**************
51
52Moon-buggy is a simple character graphics game, where you drive some
53kind of car across the moon's surface.  Unfortunately there are
54dangerous craters there.  Fortunately your car can jump over them!
55
56   Moon-Buggy comes with no warranty, to the extent permitted by law.
57You may redistribute copies of Moon-Buggy under the terms of the GNU
58General Public License.  For more information about these matters, read
59the file `COPYING' of the source code distribution or press <c> at
60moon-buggy's title screen.
61
62   Please mail any suggestions and bug reports to <voss@seehuhn.de>.
63Your message should include the moon-buggy version number, as obtained
64by the command `moon-buggy -V'.
65
66   New versions of Moon-buggy may be found on the sunsite ftp server or
67on the moon-buggy download page (*note References::).
68
69
70File: moon-buggy.info,  Node: Moon-buggy Invocation,  Next: Playing the Game,  Prev: Introduction,  Up: Top
71
722 Moon-buggy Invocation
73***********************
74
75Normal usage is to start `moon-buggy' without any options.
76Nevertheless there are some.  The long options (starting with `--') are
77only supported on some system types.
78
79`-h'
80`--help'
81     shows a short usage message.
82
83`-m'
84`--mesg'
85     disable write access to your terminal by other users, so your boss
86     can't disturb your game play with the help of "write" or "finger".
87
88`-n'
89`--no-title'
90     skips the title screen.
91
92`-s'
93`--show-scores'
94     shows the current highscore list and exits.
95
96`-V'
97`--version'
98     prints the program's version to standard output and exits.
99
100
101File: moon-buggy.info,  Node: Playing the Game,  Next: Shared Score Files,  Prev: Moon-buggy Invocation,  Up: Top
102
1033 Playing the Game
104******************
105
106The game is controlled by a couple of keys, which are described near the
107bottom of the screen.  Most important are the following keys.
108
109<SPC>
110<j>
111     makes your car jump.  The length of a jump is fixed and you can
112     only start a new jump while the wheels have contact to the ground.
113
114<a>
115<l>
116     fires the mining laser.  The laser is used to remove stones, which
117     may block your way.
118
119<q>
120     quits the game prematurely.  But you still keep your score and may
121     enter the highscore list.
122
123   Moon-buggy can handle a wide range of screen sizes.  But it runs best
124if the screen has at least 80 columns.  If you run it on a screen with
125significantly less columns it may look strange and could be hard to
126play.
127
128
129File: moon-buggy.info,  Node: Shared Score Files,  Next: Installation,  Prev: Playing the Game,  Up: Top
130
1314 Shared Score Files
132********************
133
134Moon-buggy has two concepts of score files: the "global score file" is
135located somewhere in the installation directories and is shared between
136all players.  The exact place in the file system can be controlled via
137`configure''s `--sharedstatedir' option.  This highscore file is used
138whenever Moon-buggy has the permissions to access it.  Otherwise the
139"local score file" is used.  This file is located in the user's home
140directory, the file name is `.mbscore'.  Thus, the local score file is
141not shared between different accounts.
142
143   As the game is much more fun, when players can compete for the
144highest scores, the global score file should be writable for the
145moon-buggy program (but not for the user's text editor).  Here is a
146list of possible policies:
147
148  1. The preferred solution is to make moon-buggy a setgid program.
149     This means the following: you choose a group ID, which cannot be
150     used by ordinary users, and allow only members of this group to
151     write the score file.  Many systems have a group `games' for this
152     purpose (Check your `/etc/group' file).  You make this group own
153     the `moon-buggy' executable and set the file's setgid bit.  This
154     bit gives moon-buggy its file groups's access permissions and so
155     the program is able to access the score file.
156
157     You can use `configure''s `--with-setgid' option (*note
158     Installation::) to properly set up access permissions for this
159     model.
160
161  2. You could make moon-buggy a setuid program but for security
162     reasons this is not recommended.  The file `SECURITY' from the
163     bsd-games distribution (*note References::) has some informations
164     about this topic.
165
166  3. Another solution is to make the score file world writable.  But
167     then you have to trust your players: every player may open the
168     score file with his favourite text editor and change it freely.
169     So this is not recommended, too.
170
171  4. Finally you could do nothing.  Then every account uses its local
172     score file.
173
174
175File: moon-buggy.info,  Node: Installation,  Next: References,  Prev: Shared Score Files,  Up: Top
176
1775 Installation
178**************
179
180Moon-buggy requires the curses library as a prerequisite.  If curses is
181not installed on your system, you may use the free ncurses package
182(*note References::).  The game does not work with BSD curses, thus on
183BSD systems you will need the ncurses package.
184
185   When you unpack the moon-buggy distribution, you get one directory,
186which holds all the source files and the documentation.  Generic
187installation instructions are in the file `INSTALL'.  There are some
188points of interest:
189
190   * By default, the program will be installed as
191     `/usr/local/bin/moon-buggy'.  You can specify an installation
192     prefix other than `/usr/local' by giving `configure' the
193     `--prefix=PATH' option.
194
195   * You can choose the score file's location via `configure''s
196     `--sharedstatedir=DIR' option.  The score file then will be
197     `DIR/moonbuggy/mbscore'.  On GNU/Linux systems you should use
198
199          --sharedstatedir=/var/games
200
201     to comply with the Filesystem Hierarchy Standard (*note
202     References::).
203
204   * Moon-buggy supports shared score files.  For details, see *Note
205     Shared Score Files::.  As explained there, you may want to make
206     moon-buggy a setgid program.  This can be done with the
207     `--with-setgid' option.  If you use
208
209          --with-setgid=games
210
211     then the installation process arranges everything for setgid usage.
212
213     *Caution*: this introduces potential security risks.  I tried to
214     minimise these, but nevertheless be careful with this.  And
215     remember: moon-buggy comes with no warranty.
216
217   * If your version of the curses library is not autodetected, you
218     have to use some of the `--with-curses-includedir',
219     `--with-curses-header', and `--with-curses-libs' options.  For
220     example you should use
221
222          --with-curses-includedir=/usr/pkg/include
223
224     if your curses header files are in `/usr/pkg/include/'.  You may
225     use
226
227          --with-curses-header="<mycurses.h>"
228
229     if your curses header is called `mycurses.h'.  And you may use
230
231          --with-curses-libs="-L/usr/pkg/lib -lncurses"
232
233     if your curses library is called `ncurses.a' and is located in
234     `/usr/pkg/lib/'.
235
236   Example: On GNU/Linux systems you probably can use the following
237commands.  For the last one you need root user permissions.
238
239     ./configure --sharedstatedir=/var/games --with-setgid=games
240     make
241     make install
242
243
244File: moon-buggy.info,  Node: References,  Prev: Installation,  Up: Top
245
2466 References
247************
248
249This chapter gives some references to resources mentioned in the manual.
250As the internet changes incessantly, the addresses below may be
251outdated.  If you find this to happen, please report it as a bug.
252
253   The latest version of *Moon-buggy* may be found on the sunsite
254archive in the directory
255`ftp://sunsite.unc.edu/pub/linux/games/arcade/'.
256
257   I provide a *moon-buggy download page*, which is located at
258`http://seehuhn.de/comp/moon-buggy.html'.
259
260   Version 2.0 of the *Filesystem Hierarchy Standard* (FHS 2.0) may be
261found on the internet at
262`ftp://sunsite.unc.edu/pub/linux/docs/fhs/fhs-2.0.tar.gz'.
263
264   The *ncurses* package can be found on the GNU project's ftp server
265and its mirrors.  The original site is
266`ftp://prep.ai.mit.edu/pub/gnu/ncurses/ncurses-4.2.tar.gz'.
267
268   Hints about *security concerns* may be found in the file `SECURITY'
269from the bsd-games package.  One location where to find it is
270`ftp://sunsite.unc.edu/pub/linux/games/bsd-games-2.7.tar.gz'.
271
272
273
274Tag Table:
275Node: Top993
276Node: Introduction1711
277Node: Moon-buggy Invocation2647
278Node: Playing the Game3385
279Node: Shared Score Files4262
280Node: Installation6416
281Node: References8934
282
283End Tag Table
284