LTris
				
                        a tetris clone for Linux
                             by Michael Speck
			      

********************
I.   Requirements
II.  Installation
III. Troubleshooting
IV.  Localization
V.   Feedback
********************

********************
I.   Requirements
********************
LTris runs in X and uses SDL (any version though >= 1.1.4
is recommended) and SDL_mixer (optional for sound). Both libraries
can be found at http://libsdl.org. 

********************
II.  Installation
********************
Enter your favorite shell and type in the following stuff (in the
directory you extracted the LTris source)
> ./configure [--disable-sound] [--disable-install] [--disable-nls]
              [--localstatedir=HIDIR]
    --disable-sound:       no sound
    --with-buffer-size:    modify audio buffer size (set this value
                           to 2048 if you encounter any sound delays)
    --disable-install:     no installation; play from source directory
    --localstatedir:       install global highscores to this directory
                           REPLACES --with-highscore-path TO COMPLY 
                           WITH AUTOCONF; THE DEFAULT LOCATION NOW 
                           DEPENDS ON YOUR DISTRIBUTION: PREVIOUSLY 
                           IT WAS /var/lib/games. USE
                           --localstatedir=/var/lib/games
                           FOR EXISTING HIGHSCORES.
    --disable-nls          disable gettext support
> make
> su (become root)
> make install (if install wasn't disabled)
> exit (become user again)
> ltris (run game)

********************
III. Troubleshooting
********************
If you have SDL_mixer installed but configure tells you that it can't 
find it, remember that you have to install the development package
for compiling!
---
If you can't compile because LTris' timestamps are slightly in 
the future run 'touchall' (found in the configure directory).
---
If the SDL sound seems to be out of sync first try
to modify the audio buffer by using configure option 
--with-buffer-size (set to 2048). If this fails set
SDL_AUDIODRIVER to dma (export SDL_AUDIODRIVER=dma).
  
********************
IV.  Localization
********************
This game now supports i18n. If you want to add l10n for your native language,
please contact me first, to prevent overlapping translations. A thorough
documentation can be found at 
  http://www.gnu.org/software/gettext/manual/html_mono/gettext.html
Basically, you will have to do the following:
  1) cd po
  2) add your language code (e.g., de for German) to the existing line in 
LINGUAS merely separated from the other languages by a blank
  3) run `msginit -o <LL>.po` with <LL> replaced by your language code
  4) translate the english message IDs in <LL>.po
  5) run make <LL>.gmo
Whenever you change something in your translation you'll have to repeat 
step 5). I strongly recommend to configure the program with --disable-install
while working on a translation. Otherwise you'd have to copy and rename the 
.gmo file as root every time you want to see your changes. If the source has 
been compiled without installation, only step 5) and simply running the game 
is required. (Of course, the enviroment variable LANG must be set to your 
locale.)
This should suffice. If not, please read the excellent documentation at 
gnu.org. The fonts do only contain the basic latin letters. No special letters
(like the german umlauts or any accents for example) are supported, so a l10n 
should not use them. If a string has a single %, meant as a percent sign, 
you'll have to manually remove the 'format' comment above the id (if any).

********************
V.   Feedback
********************
LGames URL:  http://lgames.sf.net
e-Mail:      http://lgames.sf.net/contact.php

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[generic]                  194     275  70.5% -lh5- dc32 May  3  2013 LTris/AUTHORS
[generic]                 2797    6130  45.6% -lh5- 67d9 Oct 29  2013 LTris/ChangeLog
[generic]                 5860   15131  38.7% -lh5- 5509 May  3  2013 LTris/COPYING
[generic]                 8209    8854  92.7% -lh5- c4ee May  3  2013 LTris/gfx/back0.bmp
[generic]                26344   27398  96.2% -lh5- 700d May  3  2013 LTris/gfx/back1.bmp
[generic]                35155   97254  36.1% -lh5- c0eb May  3  2013 LTris/gfx/back2.bmp
[generic]                37343   38478  97.1% -lh5- 738c May  3  2013 LTris/gfx/back3.bmp
[generic]                 5145    6134  83.9% -lh5- af9f May  3  2013 LTris/gfx/back4.bmp
[generic]                56421   58678  96.2% -lh5- 99d7 May  3  2013 LTris/gfx/back5.bmp
[generic]                  783    1478  53.0% -lh5- 81a0 May  3  2013 LTris/gfx/balloon.bmp
[generic]                  364    1254  29.0% -lh5- aee2 May  3  2013 LTris/gfx/balloon_peek.bmp
[generic]                 6829   14454  47.2% -lh5- 94de May  3  2013 LTris/gfx/blocks.bmp
[generic]                 2818   11062  25.5% -lh5- 77cf May  3  2013 LTris/gfx/f_small_white.bmp
[generic]                 3836   30006  12.8% -lh5- 79f3 May  3  2013 LTris/gfx/f_small_yellow.bmp
[generic]                  514     782  65.7% -lh5- fadb May  3  2013 LTris/gfx/f_tiny_black.bmp
[generic]                 4147   14774  28.1% -lh5- cf69 May  3  2013 LTris/gfx/f_white.bmp
[generic]                 6627   43254  15.3% -lh5- 9d5d May  3  2013 LTris/gfx/f_yellow.bmp
[generic]                23092   88222  26.2% -lh5- 52a1 May  3  2013 LTris/gfx/logo.bmp
[generic]                 3831   11452  33.5% -lh5- 6a19 Jan 28 14:43 LTris/gfx/Makefile
[generic]                  220     385  57.1% -lh5- 312c May  3  2013 LTris/gfx/Makefile.am
[generic]                 3709   11499  32.3% -lh5- 6aa3 Oct 29  2013 LTris/gfx/Makefile.in
[generic]               190928  308278  61.9% -lh5- 3972 May  3  2013 LTris/gfx/menuback.bmp
[generic]                 2396    4110  58.3% -lh5- cceb May  3  2013 LTris/gfx/quest.bmp
[generic]                  397     751  52.9% -lh5- 8e19 Jan 28 15:31 LTris/home/.lgames/ltris.conf
[generic]                   76     443  17.2% -lh5- 1c96 Jan 28 15:31 LTris/home/.lgames/ltris.hscr
[generic]               155525  419660  37.1% -lh5- 8557 Jan 28 15:04 LTris/ltris
[generic]                23972   23972 100.0% -lh0- 899c Jan 28 15:20 LTris/ltris.info
[generic]                 1723    3830  45.0% -lh5- eff9 May  3  2013 LTris/README
[generic]                   74      74 100.0% -lh0- 8b5b Jan 28 15:32 LTris/Readme.morphos
[generic]                  678    3056  22.2% -lh5- d93d May  3  2013 LTris/sounds/click.wav
[generic]                 6821   24794  27.5% -lh5- 864b May  3  2013 LTris/sounds/excellent.wav
[generic]                 7430   45312  16.4% -lh5- ea2b May  3  2013 LTris/sounds/explosion.wav
[generic]                  553     666  83.0% -lh5- 0fb6 May  3  2013 LTris/sounds/leftright.wav
[generic]                 3793   11349  33.4% -lh5- fa42 Jan 28 14:43 LTris/sounds/Makefile
[generic]                  182     264  68.9% -lh5- 59bc May  3  2013 LTris/sounds/Makefile.am
[generic]                 3672   11387  32.2% -lh5- 2636 Oct 29  2013 LTris/sounds/Makefile.in
[generic]                  349    3556   9.8% -lh5- 10dc May  3  2013 LTris/sounds/motion.wav
[generic]                 3568   18354  19.4% -lh5- 0f04 May  3  2013 LTris/sounds/nextlevel.wav
[generic]                  553     666  83.0% -lh5- 0fb6 May  3  2013 LTris/sounds/stop.wav
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        39 files  636928 1367476  46.6%            Jan 28 21:38