Debian Codegraph @

upstream/debian-unstable/man6/tetris-bsd.6

raw
1 .\" Automatically generated from tetris/tetris.6.in. Do not edit.
2 .\" $NetBSD: tetris.6,v 1.10 2003/08/07 09:37:48 agc Exp $
3 .\"
4 .\" Copyright (c) 1992, 1993
5 .\" The Regents of the University of California. All rights reserved.
6 .\"
7 .\" This code is derived from software contributed to Berkeley by
8 .\" Nancy L. Tinkham and Darren F. Provine.
9 .\"
10 .\" Redistribution and use in source and binary forms, with or without
11 .\" modification, are permitted provided that the following conditions
12 .\" are met:
13 .\" 1. Redistributions of source code must retain the above copyright
14 .\" notice, this list of conditions and the following disclaimer.
15 .\" 2. Redistributions in binary form must reproduce the above copyright
16 .\" notice, this list of conditions and the following disclaimer in the
17 .\" documentation and/or other materials provided with the distribution.
18 .\" 3. Neither the name of the University nor the names of its contributors
19 .\" may be used to endorse or promote products derived from this software
20 .\" without specific prior written permission.
21 .\"
22 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 .\" SUCH DAMAGE.
33 .\"
34 .\" @(#)tetris.6 8.1 (Berkeley) 5/31/93
35 .\"
36 .Dd May 31, 1993
37 .Dt TETRIS 6
38 .Os
39 .Sh NAME
40 .Nm tetris
41 .Nd the game of tetris
42 .Sh SYNOPSIS
43 .Nm
44 .Op Fl ps
45 .Op Fl k Ar keys
46 .Op Fl l Ar level
47 .Sh DESCRIPTION
48 The
49 .Nm
50 command runs display-based game which must be played on a CRT terminal.
51 The object is to fit the shapes together forming complete rows,
52 which then vanish.
53 When the shapes fill up to the top, the game ends.
54 You can optionally select a level of play, or custom-select control keys.
55 .Pp
56 The default level of play is 2.
57 .Pp
58 The default control keys are as follows:
59 .Pp
60 .Bl -tag -width "xxspacexx" -compact -offset indent
61 .It j
62 move left
63 .It k
64 rotate 1/4 turn counterclockwise
65 .It l
66 move right
67 .It Aq space
68 drop
69 .It p
70 pause
71 .It q
72 quit
73 .El
74 .Pp
75 The options are as follows:
76 .Bl -tag -width indent
77 .It Fl k
78 The default control keys can be changed using the
79 .Fl k
80 option.
81 The
82 .Ar keys
83 argument must have the six keys in order, and, remember to quote any
84 space or tab characters from the shell.
85 For example:
86 .sp
87 .Dl "tetris -l 2 -k 'jkl pq'"
88 .sp
89 will play the default games, i.e. level 2 and with the default
90 control keys.
91 The current key settings are displayed at the bottom of the screen
92 during play.
93 .It Fl l
94 Select a level of play.
95 .It Fl s
96 Display the top scores.
97 .It Fl p
98 Switch on previewing of the shape that will appear next.
99 .El
100 .Pp
101 .Sh PLAY
102 At the start of the game, a shape will appear at the top of the screen,
103 falling one square at a time.
104 The speed at which it falls is determined directly by the level:
105 if you select level 2, the blocks will fall twice per second;
106 at level 9, they fall 9 times per second.
107 (As the game goes on, things speed up,
108 no matter what your initial selection.)
109 When this shape
110 .Dq touches down
111 on the bottom of the field, another will appear at the top.
112 .Pp
113 You can move shapes to the left or right, rotate them counterclockwise,
114 or drop them to the bottom by pressing the appropriate keys.
115 As you fit them together, completed horizontal rows vanish,
116 and any blocks above fall down to fill in.
117 When the blocks stack up to the top of the screen, the game is over.
118 .Sh SCORING
119 You get one point for every block you fit into the stack,
120 and one point for every space a block falls when you hit the drop key.
121 (Dropping the blocks is therefore a good way to increase your score.)
122 Your total score is the product of the level of play
123 and your accumulated
124 .ie t points\(em200
125 .el points -- 200
126 points on level 3 gives you a score of 600.
127 Each player gets at most one entry on any level,
128 for a total of nine scores in the high scores file.
129 Players who no longer have accounts are limited to one score.
130 Also, scores over 5 years old are expired.
131 The exception to these conditions is that the highest score on a given
132 level is
133 .Em always
134 kept,
135 so that following generations can pay homage to those who have
136 wasted serious amounts of time.
137 .Pp
138 The score list is produced at the end of the game.
139 The printout includes each player's overall ranking,
140 name, score, and how many points were scored on what level.
141 Scores which are the highest on a given level
142 are marked with asterisks
143 .Dq * .
144 .Sh FILES
145 .Bl -tag -width /var/games/bsdgames/tetris-bsd.scoresxx
146 .It /var/games/bsdgames/tetris-bsd.scores
147 high score file
148 .El
149 .Sh BUGS
150 The higher levels are unplayable without a fast terminal connection.
151 .Sh AUTHORS
152 Adapted from a 1989 International Obfuscated C Code Contest winner by
153 Chris Torek and Darren F. Provine.
154 .Pp
155 Manual adapted from the original entry written by Nancy L. Tinkham and
156 Darren F. Provine.
157 .Pp
158 Code for previewing next shape added by Hubert Feyrer in 1999.