+-------+
| About |
+-------+

GNU Robbo is a free open source reimplementation of Janusz Pelc's
Robbo for the Atari XE/XL which was distributed by LK Avalon in 1989.

+---------+
| History |
+---------+

The first version of Robbo was released in 1989 by LK Avalon, and in a
short time became very popular in "little" Atari's world. Their main
developer Janusz Pelc did a very good job. There are rumours that he
wrote the game just three months before his graduation exam ;) In 1990
Janusz Pelc and LK Avalon released their next product -- Robbo
Konstructor -- which enabled people to create their own levels.

In 1991, Maciej Miasik (http://www.linkedin.com/in/tosiabunio)
developed The Adventures of Robbo for XLanD Games -- an updated
PC-DOS port of the Atari version -- and published by Epic Games. In
2006 Maciej Miasik declared that the idea and code of the PC-DOS
version to be licenced under the Creative Commons Attribution-Share
Alike 2.5 Generic licence
(http://www.miasik.net/archive/2006/06/moje-gry-dla-kazdego/).

I (Alus) just ported it to Linux trying to set Robbo's behaviour as 
similar as it is possible. You can still buy Windows version of Robbo
in "LK Avalon", with better graphics and new objects and levels.
Thunor joined the project in 2007 and completely rebuilt first version.

+------------------------------------------+
| A More Complicated History, Allegedly :p |
+------------------------------------------+

Janusz Pelc's company XLanD Games created the Atari Robbo game and
it was distributed by LK Avalon, a promoter of independent developers.
In 1991 whilst working for XLanD Games, Maciej Miasik created the PC
version. In 1994 XLanD Games agreed to sell the rights to the PC
version to LK Avalon and then XLanD Games went out of business. Later
in 1996, Maciej Miasik joined LK Avalon and worked on several projects
until 2001. In 2006 with the permission of past and present LK Avalon
employees he released the PC version under a Creative Commons licence.

As far as licencing goes, any agreements between Janusz Pelc/XLanD
and LK Avalon regarding the Atari version disappeared with the demise
of XLanD Games, but the GNU Robbo team have been told that the Atari
Robbo game was the property of Janusz Pelc/XLanD Games and Janusz
Pelc has no problems with the existence of the GNU Robbo project.

+--------------+
| Requirements |
+--------------+

libSDL
libSDL_mixer
libSDL_image
and accompanying devel packages.

Optional: libSDL_ttf and accompanying devel package.

Most Linux distributions come pre-installed with these libraries but
but you will likely have to install the development versions yourself.

For more information about the SDL libraries, please visit
http://www.libsdl.org/
http://www.libsdl.org/projects/SDL_mixer/
http://www.libsdl.org/projects/SDL_image/
http://www.libsdl.org/projects/SDL_ttf/

+--------------+
| Installation |
+--------------+

See COMPILING.

+------+
| Keys |
+------+

Default PC controls :-

	Enter				Confirm
	Cursors				Move
	Cursors + RShift	Shoot
	R					Restart
	Escape				Exit

All keys are reconfigurable and are listed in Options. Digital and
analogue joysticks are also supported and it's possible to mix input
devices.

+-----------------+
| Pointer Support |
+-----------------+

The game can be controlled entirely with a pointing device (mouse or
stylus). By default the menu items throughout the game can be clicked,
and to activate the in-game control pad and toolbar you should simply
click anywhere on the screen. To shoot use either of these methods :-

* Drag from Robbo to a direction to shoot once and remain in walk mode.
* Click Robbo to toggle shoot mode on, press a direction to shoot one
  or more bullets and then click Robbo again to toggle shoot mode off.

+---------------+
| Music Support |
+---------------+

Now GNU Robbo Supports playing music.

The way it does it, it plays ogg files during the game, if you go back
to the main screen, music stops, and it is resumed when you get back.
If music is on, volume keys control music volume, if it is disabled
they control sound fx volume.

If you want to have music, there are some things you should do:

First of all, find some music in ogg format, you want to be played in
the game. Place the ogg files in the data/music directory.

Then uncomment line in the Makefile:

	#MUSIC=-DHAVE_MUSIC="yes"

and rebuild GNU Robbo with:

	make clean
	make

and you should have music playing.

WARNING: Music support is kind of experimental, that is why it is
disabled by default.

+----------------------+
| Command Line Options |
+----------------------+

GNU Robbo version 0.64
Usage: gnurobbo [options]

Options:
	-XRESxYRES	e.g. -800x480
	-ts n		Tile size 16 or 32
	-vpx		Maximise the viewport
	-f			Run the game fullscreen

The tile size of 16 is used in video modes less than 480x480.
On suitably large video modes, maximising the viewport will enable you
to see more of the level but this is considered cheating and is only
meant for level design and testing. Still, if you are interested in
designing levels you may want to try ./gnurobbo -800x600 -ts 16 -vpx

+-------------+
| Level files |
+-------------+

You can create own level files - more details can be found in
original.dat. Don't hesitate to send complete working levels to the
author. If it's sensible, be sure that it will be attached to official
game :-)

Homepage of this game is available at: http://gnurobbo.sourceforge.net

-- The GNU Robbo Team


