games/tetris/tetris.6

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