README - Same for Sharp Zaurus
======================================


Same for the Zaurus by Uwe Koch (asys3@web.de)
http://www.linuxvision.de/zaurus.html

after the idea of:

Samegame for Agenda VR3
- original CVS at http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/agenda-ja/same/
- SameGame for Agenda VR3 by Takano Ryousei (takano@os-omicron.org) 
  http://tiki.is.os-omicron.org/en/tiki.cgi?c=v&p=AgendaVR3
- TileSets from Bill Kendrick (bill@newbreedsoftware.com) and 
  Bernhard Trummer (bernhard.trummer@gmx.net) (basic + 3D),
  froot (fruit tileset) by Thorsten Scheuermann and
  puzzle (puzz-le) by Walter Rawdanik
  

Basic Frame and code parts from:
- Karl Bartel's (karlb@gmx.net) zTappy at http://www.linux-games.com/zaurus 

This is free software according to the GPL (see separate file for details).

I'm not responsable for any damage that results from the use of this software !

Feel free to send any comments to:
Uwe Koch - asys3@web.de

----------------------------
Rules:

Goal: Remove as many adjacent blocks at once. Champions: clear the whole board !

Removing blocks: Click on a piece if at least one same piece is around
                 (top, bottom, left or right). Click on one of these pieces, to remove them.
		 Shrinking of freed place is made from right to left and from bottom up.
		 
Score: Calculated by the square of (#pieces-2)
----------------------------
Features:
- Highscore
- 4 Tilesets
- Sound / Zaurus Buzzer: If you enable key click, every removed piece makes a click.
- Light: An entry in the highscoretable flashes the email LED slowly. If you're the
         Top Banana - it flashes fast ;-)
- Display of actual remaining tiles
- C-series support (640x480)
----------------------------
Changelog:

V1.2.0 - 04/11/04
- autodetect Zaurus model - force 640x480 when detecting C-Series - otherwise try 320x240
as default resolution
- remove bug in highscore list

V1.0.1 - 01/05/03 
- sound switch (to disable in OZ)
- new arranged tile menu

V1.0.0 - 20/10/02
- Highscore completed (QInputDialog::getText is not included in Qtopia -
  so I have to include it in the game (like knights does...)
- Control LEDs when in highscore table ;-)

V0.4.0 - 01/10/02
- Removed mono tileset
- New menu: settings
- Display of remaining tiles per type
- Highscore 1st version (not permanent - anybody knows how to
  compile QInputDialog::getText ?)
- Improved icon for desktop

V0.3.0 - 23/08/02
- Added fruit tileset
- Added puzzle tileset
- Added sound (activated by allowing key clicks !)
- Reimplementation of GameOver - hope the bug is away...

V0.2.0 - 20/08/02
- Added color tileset (default)
- Added colored icon

V0.1.0 - 19/08/02
First release - black & white

---------------------------------------

Compile / packaging instructions
================================
1. Set target environment with
  - ". /setenv" in this directory if you want to compile on Intel/Linux 
  - ". /zetenv" in this directory if you want to crosscompile for Arm/Zaurus 
  ( check if these both scripts both have the correct paths of your system)
2. "tmake same.pro > Makefile" to create the makefile according to your compile target  
3. "make" to compile + link
4. "./same" to start the program
   - For Intel: start "qvfb &" and "qpe" before
5. To get a Zaurus package after the compile, type "./makepkg.sh"

For further details of compiling a QT programm look at the documentation at trolltech.com.