SYNOPSIS

       /usr/games/tetris                                            [-geometry
       [{width}][x{height}][{+-}{xoff}[{+-}{yoff}]]]                 [-display
       [{host}]:[{vs}]]   [-[no]mono]   [-[no]{reverse|rv}]  [-{foreground|fg}
       {color}]  [-{background|bg}  {color}]  [-frame  {color}]  [-{border|bd}
       {color}] [-[no]sound] [-bumpSound {filename}] [-level {starting_level}]
       [-units  {size_of_polyomino}]  [-columns  {columns}]   [-fill   {rows}]
       [-[no]fixedFill]   [-[no]suddenAppear]   [-[no]diagonal]   [-[no]mixed]
       [-[no]bonus]   [-[no]cw]   [-[no]plain]   [-[no]showNext]    [-userName
       {string}] [-scoreFile {filename}] [-scores] [-version]


DESCRIPTION

       The  ever  popular falling tetromino game.  Enhanced to allow all poly-
       omino classes that do not have pieces  with  holes.   Mixing  polyomino
       classes  (so  as  to  permit  polyominoes  made up by a variable number
       squares) can also be selected, as well as, the 2 sets of diagonal poly-
       ominoes that do not have pieces with holes.

       To  make  these  games  interesting and "do-able" the ability to rotate
       gets turned off if it is easier than the 4 square polyomino.  An  added
       ability  "reflect" (right-left -> left-right) allows one to attempt the
       5 square and 6 square polyomino pieces.

       To get high scores, do not use "show next"  mode,  try  starting  at  a
       higher  level and try to let "tetris" eat more than one line at a time.
       Polyominoes with diagonal or with a higher number of squares earn  more
       points.   Mixed mode earns less points.  Play fast and see how well you
       can do in the bonus mode.  Bonuses are set when the  level  is  changed
       automatically.   (Bonus  mode  not available for 6 squares or 3 squares
       and diagonal mode).

       The program lists the top 15 players at the end,  each  player  has  at
       most  three  scores.  With the option -scores, it shows all the players
       and scores.


FEATURES

       Click "mouse-left" button, or press "J", "j", "S", or "s" keys to  move
       the falling polyomino left.

       Click  "mouse-center"  button,  or  press "K", "k", "D", or "d" keys to
       rotate the falling polyomino.  Note this  may  be  turned  off  if  the
       depending on the "turn-style", but normally this is "on".

       Click "mouse-right" button, or press "L", "l", "F", or "f" keys to move
       the falling polyomino right.

       Click "mouse-scroll-up", or press "I", "i", "E", or "e"  keys  to  flip
       (reflect)  the  falling  polyomino.  Note this may be turned off if the
       depending on the "turn-style", but normally this is "off".

       Click "mouse-scroll-down", or press "space-bar"  to  drop  the  falling
       polyomino.

       Press  "<" or "," keys to slow down the falling polyomino.  This may be
       turned off to avoid cheating.

       Press "+" or "=" keys to increase the squares in the falling polyomino.
       Note:  To  keep the level of play similar, the "turn style" can change.
       The ability to reflect polyominoes is available only when the number of
       squares  >=  5.   The  ability to rotate polyominoes, is available only
       when the number of squares is >= 4.  Bonus polyominoes still  have  the
       current "turn style".

       Press "-" or "_" keys to decrease the squares in the falling polyomino.

       Press "]" or "}" keys to increase the column/row size.

       Press "[" or "{" keys to decrease the column/row size.

       Press "`", "1", "2", "3", "4", "5", "6", "7", "8",  "9",  or  "0"  keys
       (not  the  keypad  0-9)  to change the number of fill lines.  "`" for 0
       lines and "0" for 10 lines.

       Press "X" or "x" to toggle between fixed fill or random fill.

       Press "R" or "r" to toggle between sudden initial appearance or gradual
       initial appearance.

       Press  "G"  or  "g" to toggle diagonal mode.  This may not be available
       for current number of squares.

       Press "M" or "m" to toggle mixed mode.  This may not be  available  for
       current number of squares.

       Press  "B"  or "b" to toggle bonus mode.  This may not be available for
       current number of squares.

       Press "W" or "w" to toggle clockwise or counter clockwise turning.

       Press "P" or "p" to toggle plain pieces or three dimensional pieces.

       Press "N" or "n" to toggle show next.

       Press "|" key to pause.

       Press "@" key to toggle the sound.

       Press "Esc" key to hide and pause  program.   When  the  tetris  window
       loses  its  focus,  it  also  goes  to "paused" mode except it does not
       iconify itself.

       Press "Q", "q", or "CTRL-C" keys to kill program.


OPTIONS


       -{foreground|fg} color
               This  option  specifies  the  foreground  of  the tetris window
               (resource name "foreground").

       -{background|bg} color
               This option specifies  the  background  of  the  tetris  window
               (resource name "background").

       -{border|bd} color
               This  option  specifies  the  border color of the blocks in the
               tetris window (resource name "borderColor").

       -[no]sound
               This option specifies if row completion should make a sound  or
               not (resource name "sound").

       -bumpSound filename
               This  option  specifies  the  file for the bump sound (resource
               name "bumpSound").

       -level level
               This option starts the program at the specified level (resource
               name "startLevel").

       -units ize_of_polyomino
               This  option  starts  the  program with the specified number of
               squares in each polyomino (resource name "units").

       -columns columns
               This option starts the program with  the  specified  number  of
               columns  (number  of  rows  is 2 * number of columns) (resource
               name "columns").

       -fill rows
               This option indicates that the program should start  with  some
               of the rows being randomly filled (resource name "fill").

       -[no]fixedFill
               Works  only  with  the  -p  option where it fixes the number of
               boxes to be filled to column size / 2 -  1  random  blocks  per
               row. (resource name "fixedFill").

       -[no]suddenAppear
               Polyominoes will now suddenly appear within the window. Now one
               cannot rotate a piece above the window. (resource name  "sudde-
               nAppear").

       -[no]diagonal
               This option turns diagonal mode on (only available on -n <2-3>)
               (resource name "diagonal").

       -[no]plain
               Uses  the  old  "plain"  bitmaps instead of the default 3D ones
               (resource name "plain").

       -[no]showNext
               This option  tells  the  program  start  in  "show  next"  mode
               (resource name "showNext").

       -userName name
               This  option  speicfies  the  user name for any records made or
               else it will get your login name (resource name "userName").

       -scoreFile filename
               Specify an alternative score file (resource name  "scoreFile").

       -scores This option lists all the recorded scores and then exits.

       -version
               This option tells you what version of tetris you have.


REFERENCES

       Based at one time on Q. Alex Zhao's Tetris.


SEE ALSO

       X(1), welltris(6), tertris(6), hextris(6), xhextris(6), xmris(6)


COPYRIGHTS

       (R) Copyright 1993-2006, David A. Bagley, <bagleyd@tux.org>.  (R) Copy-
       right 1992-1995, Q. Alex Zhao, <azhao@cc.gatech.edu>.


BUG REPORTS AND PROGRAM UPDATES

       Send bugs (or their reports, or fixes) to the author:
              David Albert Bagley, <bagleyd@tux.org>

       The latest version is currently at:
              ftp://ftp.tux.org/pub/tux/bagleyd/altris
              ftp://ibiblio.org/pub/Linux/games/arcade/tetris



V7.2.1                            05 May 2006                        TETRIS(6)