Sync usage with man page.
[netbsd-mini2440.git] / games / robots / robots.6
blob6e8a13b3840cfdbb17f91be4a5333056ca45f790
1 .\"     $NetBSD: robots.6,v 1.14 2009/04/09 03:52:54 joerg Exp $
2 .\"
3 .\" Copyright (c) 1991, 1993
4 .\"     The Regents of the University of California.  All rights reserved.
5 .\"
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
8 .\" are met:
9 .\" 1. Redistributions of source code must retain the above copyright
10 .\"    notice, this list of conditions and the following disclaimer.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\"    notice, this list of conditions and the following disclaimer in the
13 .\"    documentation and/or other materials provided with the distribution.
14 .\" 3. Neither the name of the University nor the names of its contributors
15 .\"    may be used to endorse or promote products derived from this software
16 .\"    without specific prior written permission.
17 .\"
18 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 .\" SUCH DAMAGE.
29 .\"
30 .\"     @(#)robots.6    8.1 (Berkeley) 5/31/93
31 .\"
32 .Dd August 4, 2009
33 .Dt ROBOTS 6
34 .Os
35 .Sh NAME
36 .Nm robots
37 .Nd fight off villainous robots
38 .Sh SYNOPSIS
39 .Nm
40 .Op Fl Aajnrst
41 .Op Ar maximum
42 .Op Ar scorefile
43 .Sh DESCRIPTION
44 .Nm
45 pits you against evil robots, who are trying to kill you (which is why
46 they are evil).
47 Fortunately for you, even though they are evil, they are not very bright
48 and have a habit of bumping into each other, thus destroying themselves.
49 In order to survive, you must get them to kill each other off, since you
50 have no offensive weaponry.
51 .Pp
52 Since you are stuck without offensive weaponry, you are endowed with one
53 piece of defensive weaponry: a teleportation device.
54 When two robots run into each other or a junk pile, they die.
55 If a robot runs into you, you die.
56 When a robot dies, you get 10 points, and when all the robots die,
57 you start on the next field.
58 This keeps up until they finally get you.
59 .Pp
60 Robots are represented on the screen by a
61 .Sq \&+ ,
62 the junk heaps from their collisions by a
63 .Sq \(** ,
64 and you
65 (the good guy)
66 by a
67 .Sq @ .
68 .Pp
69 The commands are:
70 .Bl -tag -width indent -compact
71 .It Ic h
72 move one square left
73 .It Ic l
74 move one square right
75 .It Ic k
76 move one square up
77 .It Ic j
78 move one square down
79 .It Ic y
80 move one square up and left
81 .It Ic u
82 move one square up and right
83 .It Ic b
84 move one square down and left
85 .It Ic n
86 move one square down and right
87 .It Ic \&.
88 (also space) do nothing for one turn
89 .It Ic HJKLBNYU
90 run as far as possible in the given direction
91 .It Ic \*[Gt]
92 do nothing for as long as possible
93 .It Ic t
94 teleport to a random location
95 .It Ic w
96 wait until you die or they all do
97 .It Ic q
98 quit
99 .It Ic ^L
100 redraw the screen
103 All commands can be preceded by a count.
105 If you use the
106 .Sq Ic w
107 command and survive to the next level, you will get a bonus of 10%
108 for each robot which died after you decided to wait.
109 If you die, however, you get nothing.
110 For all other commands, the program will save you from typos
111 by stopping short of being eaten.
112 However, with
113 .Sq Ic w
114 you take the risk of dying by miscalculation.
116 Only five scores are allowed per user on the score file.
117 If you make it into the score file, you will be shown the list at the end
118 of the game.
119 If an alternative score file is named on the command line, that file
120 will be used instead of the standard file for scores.
121 The score file must be created empty beforehand, e.g. with
122 .Xr touch 1 .
123 If the argument
124 .Ar maximum ,
125 which must be a number, is provided when a score file is first used,
126 the value given will be used as the maximum number of scores to keep
127 per user instead of the default five.
128 This value is a property of the score file and cannot be changed later.
130 The options are
131 .Bl -tag -width indent
132 .It Fl A
133 Auto-bot mode.
134 Lets the game play itself.
135 .It Fl a
136 Advance into the higher levels directly, skipping the lower, easier levels.
137 .It Fl j
138 Jump,
139 .Em i.e. ,
140 when you run, don't show any intermediate positions; only show things at
141 the end.
142 This is useful on slow terminals.
143 .It Fl n
144 Increase the number of games played by one; that is, automatically
145 choose to play again one time per usage of this option.
146 .It Fl r
147 Play in real time; that is, if you do nothing for a few seconds the
148 game will assume you meant to do nothing and move the robots.
149 .It Fl s
150 Don't play, just show the score file.
151 .It Fl t
152 Teleport automatically when you have no other option.
153 This is a little disconcerting until you get used to it, and then it is
154 very nice.
156 .Sh FILES
157 .Bl -tag -width /var/games/robots_roll -compact
158 .It Pa /var/games/robots_roll
159 The score file.
161 .Sh AUTHORS
162 .An Ken Arnold
163 .An Christos Zoulas
164 (autobot mode)
165 .Sh BUGS
166 Bugs?
168 .Em crazy ,
169 man?!?