	GENERIC WELLTRIS
	================	Yet Another Tetris Game on X, V1.3.2

Primary site: ftp://ftp.tux.org/pub/tux/bagleyd/altris
Secondary site: ftp://ftp.x.org/contrib/games/altris
Web page: http://www.tux.org/~bagleyd/altris.html
Maintainer: David A. Bagley <bagleyd@tux.org>

WHY ANOTHER?

    Because "different is good"...

    Because this one is simple, easy to build, portable, and deep.
    It only uses Xlib -- no "toolkit" kind of thing.

    A 3-D well and different kinds of polyominoes than Q. Alex Zhao's
    tetris, which this program is patterned after.  That original
    tetris can be found ftp.x.org under /contrib/games .

HOW TO BUILD?

    Edit the Imakefile (or Makefile.std, see below) for appropriate
    settings of variables SCOREFILE, UP, and DOWN, then do:
	xmkmf
	make
	./welltris

    Note: if you don't have 'xmkmf' or the "Makefile" it generates
    doesn't work well, edit Makefile.std for appropriate settings for
    XINCLUDEPATH and XLIBPATH, then try:
	make -f Makefile.std

    "Welltris" is the game.  It only lists the top 15 players at the
    end, each player may have at most three scores.  With the option
    "-s", "welltris" will list all the scores.


ANYTHING SPECIAL IN PLAYING?

    Use 'j' to move left; 'l' to move right; 'k' to rotate; 'i' to 
    reflect.  Left-handed people may want to use 's', 'f', 'd', 'e'
    respectively.  Use the space bar to drop a block quickly.  Do you
    want to try the arrow keys or keypad?

    Use CTRL-L key combination to redraw -- in case the program messes
    something up.

    As usual, '+' speeds up the game.  To avoid cheating "-" is
    disabled from slowing down the game.  Note: that you do not need to
    press the SHIFT key -- '=' also works.  The 'b' key can be used to
    toggle "beep" and 'n' toggles "show next".  '>' will increase and
    '<' will decrease the number of squares in a polyomino.  Again, you
    do not need to press the SHIFT key -- '.' and ',' also work.  (Since
    it would lead to cheating, the number of squares can not be decreased
    from 3).  If available for the current number of squares, the 'g' key
    toggles the "diagonal" mode, the 'm' key toggles the "mixed" mode, and
    the "r' key toggles the grid.  Note: to keep the level of play similar,
    the ability to reflect polyominoes, and later the ability to rotate
    polyominoes, may get turned off when the number of squares in a
    polyomino is decreased.

    'g' key toggles the "diagonal" mode (this automatically decrements the
    number squares by 1 and increments the number of squares by 1 when
    toggled off), 'm' toggles the "mixed" mode, and 'r' toggles the grid.

    If you press 'p', the game will be paused, and the window will be
    iconified -- just in case your boss suddenly appears at your door.
    ;o) When the tetris window loses its focus, it also goes to
    "paused" mode except it doesn't iconify itself.

    Refer to the man page for detailed command line options.


FOUND A BUG?

    Send bug reports (or fixes) to David Bagley <bagleyd@tux.org>
    (well, a lot was taken from Q. Alex Zhao's tetris but many of the
    algorithms were taken from xvwelltris written by me).
