README for petris-1.05.tar.gz

1. SYNOPSIS
2. REQUIREMENTS
3. FILES
4. INSTALLATION
5. CHANGES
6. COPYRIGHT
7. NOTES


1. SYNOPSIS

This is the classic version of tetris. It has some enhancements (which can be
switched off), including patterns (layouts) of predetermined blocks already on
the board, changeable board sizes, changeable speed and extra shapes. You can
add new layouts and shapes easily.

On-line help is provided - start up the game and click the Help button or press F1. 


2. REQUIREMENTS

Perl 5.004
Tk 400.202
Linux/X windows or Win32

The game was developed under Debian GNU/Linux 2.0.

60K disk space.


3. FILES

README
debian-menu
petris
petris-action.pl
petris-board.pl
petris-button-commands.pl
petris-buttons.pl
petris-consts.pl
petris-help.pl
petris-icon-16x16.xpm
petris-keys.pl
petris-layouts.pl
petris-options.pl
petris-opts.pl
petris-shapes.pl

Petris will create a directory in your home directory called '.games' and a
file in that directory called 'petris-opts'. On Win32 machines it will create
a file called 'PETRIS.INI' in the directory it is invoked from.


4. INSTALLATION

Note that Petris can be installed pretty well anywhere - the only restriction
is that all the petris* files must be together in the same directory.

# Create the directories.
mkdir /usr/games
mkdir /usr/games/petris

# Copy the tar.gz to the game directory.
cp petris-1.05.tar.gz /usr/games

# Change to the games directory.
cd /usr/games

# Unpack the archive using method A or B:
# Method A for those using GNU tar
tar xvfz petris-1.05.tar.gz
# Method B for those not using GNU tar
gunzip petris-1.05.tar.gz
tar xvf petris-1.05.tar

# Change to the petris directory.
cd petris

# Move the library file into the Tk directory.
# (The -u option ensures we don't overwrite newer with older.)
# Note that you could move this to any Tk directory in any lib directory in
# Perl's %INC path, or in /usr/games/petris/Tk.
mv -u MesgBox.pm /usr/lib/perl5/Tk

# Make sure petris is executable.
chmod a+x petris

# If you want petris to appear on your X menu do the following:
cp debian-menu /etc/menu/petris
update-menus

# Note that the name of the file supplied, 'debian-menu', is changed in the
# move to 'petris'. Note also that if you haven't used the paths given here you
# must change the command path in /etc/menu/petris. The addition to the menu
# will only appear when the window manager is restarted.

# To run petris from the command line:
/usr/games/petris/petris &

# You could always either alias this or use a soft link to a directory on the
# path to save typing the whole path. Note that 'deprecated' error messages
# which appear are harmless and can be ignored.


5. CHANGES

1999/01/23  Modified options so that the program need not exec itself when the
            board size is changed. Also improved modularisation.

1999/02/02  Corrected a mistake that stopped buttons working with the mouse.
            Made the game 'friendlier' to Win32 machines.

1999/02/23  Changed to use MesgBox dialog - should now work properly under
            Windows.


6. COPYRIGHT

Copyright (c) Mark Summerfield 1998/9. All Rights Reserved.
Petris may be used/distributed under the same terms as Perl.

Contact: <mark.summerfield@chest.ac.uk> - please include 'petris' in the
subject line. 


7. NOTES

When I installed Debian Linux I was surprised to find that no Tetris was
supplied. I felt this was a gap that I would like to fill. After developing
Snake in a way that I felt would lend itself to the development of other
'graph-paper' games, I decided to put it to the test and so developed this
version of Tetris. I have called the game Petris because Andreas Koenig
pointed out that Tetris was probably a trademark - the name Petris was
suggested by Jarkko Hietaniemi. I think that the code supplied here could be
adapted to many other 'graph-paper' games. 

To customise by adding new shapes edit the petris-shapes.pl file (after making
a backup and reading the comments first of course!) Similarly to add new
layouts edit petris-layouts.pl.


