[Xbubble-commits] xbubble/man Makefile.am,NONE,1.1 xbubble.6,NONE,1.1

[Martin Quinson]

Update of /cvsroot/xbubble/xbubble/man
In directory haydn:/tmp/cvs-serv23400

Added Files:
	Makefile.am xbubble.6 
Log Message:
Import from savanah

--- NEW FILE: xbubble.6 ---
.TH XBUBBLE 6
.SH NAME
xbubble \- an X Window based puzzle bubble clone
.SH SYNOPSIS
.B xbubble
.I [OPTION]
.SH DESCRIPTION
.B XBubble
is a Puzzle Bubble (PB) / Bust-A-Move (BAM) clone for Unix/X11 
platforms. It was written from scratch with no real intent to exactly 
reproduce the original game.

.SH OPTIONS
.TP
.B \-d DISPLAY
Set X display to DISPLAY.
.TP
.B \-s <scale>
Set game window size (between 5 and 100).
The game window size is normally automatically scaled to your screen size.
This option is useful to reduce load on slow/loaded systems. See also the
.I "-f"
option.
.TP
.B \-f <framerate>
Adjust frame rate (in frames per second). Usual values are 100 (default), 50, 
33, 25, etc. The actual frame rate may be different from the one you specified,
depending on system timer resolution. You can use this option to reduce load 
on slow/loaded systems (e.g. if sprite animation is jerky). See also the 
.I "-s"
option.
.TP
.B \-r <resource path>
Tell XBubble to look for its graphics files, fonts, etc. in directory 
<resourcepath>.
.TP
.B \-t <theme name>
Use the given theme (possible values are: plain, frozen, fancy).

.SH PLAYING

The goal is to clear all bubbles from your board and avoid bubbles dropping
below the line at the bottom of the screen. You can rotate and fire
a canon that launches colored bubbles. Bubbles bounce against
the walls until they get stuck to another bubble. If you get three or more
adjacent bubbles of the same color they all explode, while any bubble left
hanging free falls down.

In single player mode, the ceiling goes down every 12 launches so that you
must clear the board before the ceiling touches the ground.

In multi-player mode, the ceiling does not move but a fresh row of
bubbles is added on top of the board while all bubbles are
lowered by one row. Additionally, each time you explode three or more
bubbles, all extra bubbles are sent (with random colors) to your opponent, 
as well all falling bubbles.
You win the round when your opponent loses (has bubbles dropping across 
the bottom line).

After a few seconds delay, your canon launches its bubble anyway. You can tune
this delay when selecting your 
.I handicap.
The higher the handicap, the shorter the delay.

.SH "GAME CONTROL"
The game is entirely controlled using the keyboard:

.B "Player 1"
.IP
Left arrow / Keypad 4   =  Rotate canon left
.IP
Right arrow / Keypad 6  =  Rotate canon right
.IP
Up arrow / Keypad 5     =  Launch bubble

.TP
.B
Player 2
.IP
x  =  Rotate canon left
.IP
v  =  Rotate canon right
.IP
c  =  Launch bubble

.TP
.B
General
.IP
Up arrow / Keypad 8    =  Menu navigate up
.IP
Down arrow / Keypad 2  =  Menu navigate down
.IP
p                      =  Pause
.IP
Escape / q             =  Abort

There is no command-line option for changing control keys yet.

.SH "PLAYER VS COMPUTER MODE"

You can choose between 5 levels of difficulty.
Beware of the highest level if you have a slow machine, as it is quite
CPU consuming. 

.SH BUGS
Please report any bugs you find to one of the authors whom address in
indicated below.
.SH LICENSE
.B xbubble
is covered by the GNU General Public License (GPL).
.SH "SEE ALSO"
.BR frozen-bubble (6).
.SH AUTHORS
 Ivan Djelic <ivan@savannah.gnu.org>
 Martin Quinson <martin.quinson@tuxfamily.org>

--- NEW FILE: Makefile.am ---
man_MANS = xbubble.6
EXTRA_DIST = $(man_MANS)