145 lines
5.2 KiB
Plaintext
145 lines
5.2 KiB
Plaintext
.TH GTKBALLS 6x "A simple logic game" "Version 3.1.5"
|
|
.SH NAME
|
|
gtkballs \- A simple logic game
|
|
.SH SYNOPSIS
|
|
.B gtkballs
|
|
[options]
|
|
.SH DESCRIPTION
|
|
This manual page documents
|
|
.BR GtkBalls.
|
|
.BR GtkBalls
|
|
is a simple logic game. The goal of this game is to make the highest score
|
|
by matching a number of balls of the same color in a horizontal, vertical or
|
|
diagonal line. For further information on how to play this game refer to the
|
|
rules section in this manual page.
|
|
.SH OPTIONS
|
|
.TP
|
|
.I "\--display [hostname:dpy]"
|
|
Specify what display GtkBalls should use. See
|
|
.BR X
|
|
(1x) for more information on the syntax of hostname and display.
|
|
.SH RULES
|
|
The standard play area of GtkBalls is a 9x9 grid (it can be changed through
|
|
"Rules" option in ingame menu). When GtkBalls is first started a number of
|
|
balls are placed in a random manner on the grid. Balls are in different colors
|
|
(and/or shape). You may move balls on the grid by selecting them and selecting
|
|
an empty square on the grid as destination for the ball you selected. Balls
|
|
will only move if they are not blocked by other balls. Each time you move a
|
|
ball, unless you score some points, new balls appear in a random manner on the
|
|
grid. If the grid is full then the game is lost. However this is bound to
|
|
happen, your goal is to make the highest score. In order to do this you must
|
|
make lines in a vertical, horizontal or diagonal way with balls of the same
|
|
color. By default a line must have at least five balls of the same color (it
|
|
can also be changed through "Rules" option in ingame menu). Making a line of
|
|
minimum amount of the balls, specifed in rules, will earn you twice the points
|
|
for your score. If you make lines over minimum amount of the balls it will earn
|
|
you even more points. In order to help you decide which ball you are going to
|
|
move, there is an indicator on top of the grid that shows what colors the next
|
|
balls that will appear on the grid will be.
|
|
.SH USING THE INTERFACE
|
|
GtkBalls is a graphical program using the Gtk+ windowing toolkit. This section
|
|
describes it's user interface.
|
|
.SS THE GAME MENU
|
|
.TP
|
|
.I New
|
|
Selecting this menu entry will abandon the current game and start a new one or
|
|
start another game if you just finished one. You may use the keyboard shortcut
|
|
.BR CTRL-N
|
|
to do this also.
|
|
.TP
|
|
.I Rules
|
|
Selecting this menu entry will open "Rules" dialog box, where you can set board
|
|
width and height, number of different objects to appear on the board, number
|
|
of objects that will appear on the board after each turn and number of
|
|
objects that must form the line to eliminate it. You may use the keyboard
|
|
shortcut
|
|
.BR CTRL-R
|
|
to do this also.
|
|
.TP
|
|
.I Save
|
|
Selecting this menu entry will open "Save game" dialog box, where you can save
|
|
current game to play it later. You may use the keyboard shortcut
|
|
.BR CTRL-S
|
|
to do this also.
|
|
.TP
|
|
.I Load
|
|
Selecting this menu entry will open "Load game" dialog box, where you can load
|
|
previously saved game. You may use the keyboard shortcut
|
|
.BR CTRL-L
|
|
to do this also.
|
|
.TP
|
|
.I Hall Of Fame
|
|
Selecting this menu entry will open a dialog box showing the high scores. Only
|
|
the ten best scores are shown. This dialog also displays the name of the person
|
|
who achieved a high score and it's date. You may use the keyboard shortcut
|
|
.BR CTRL-H
|
|
to do this also.
|
|
.TP
|
|
.I Quit
|
|
Selecting this menu entry will quit GtkBalls. You may use the keyboard shortcut
|
|
.BR CTRL-Q
|
|
to do the same thing.
|
|
.SS THE EDIT MENU
|
|
.TP
|
|
.I Undo
|
|
Selecting this menu entry will undo your last move. You may use the keyboard
|
|
shortcut
|
|
.BR CTRL-U
|
|
to do this also.
|
|
.SS THE SETTINGS MENU
|
|
.TP
|
|
.I Preferences
|
|
Selecting this menu entry will open the "Preferences" dialog box. You may use
|
|
the keyboard shortcut
|
|
.BR CTRL-P
|
|
to open it also.
|
|
This dialog box allows you to set some options. Click on a check box to
|
|
activate or deactivate them. Click on the theme name to select it.
|
|
Then click on the
|
|
.B Apply
|
|
button to save your settings or click on
|
|
.B Ok
|
|
button to save your settings and close this dialog box.
|
|
You can disable the showing of footprints,
|
|
path of the ball, color of the next balls indicator, animation of disappearing
|
|
of the ball and set time limit per move from this dialog box.
|
|
.SS THE HELP MENU
|
|
.TP
|
|
.I Rules
|
|
Selecting this menu entry will display a dialog box describing rules of the
|
|
game. You may use the keyboard shortcut
|
|
.BR F1
|
|
to open it also.
|
|
.TP
|
|
.I About
|
|
Selecting this menu entry will display a dialog with the logo and the
|
|
copyright information of GtkBalls. You may use the keyboard shortcut
|
|
.BR CTRL-A
|
|
to open it also. For more details on the license, click
|
|
on the
|
|
.BR "Show license"
|
|
button. This will open another dialog box where you can read the GNU General
|
|
Public License.
|
|
.SH SEE ALSO
|
|
The
|
|
.BR GtkBalls
|
|
web site at:
|
|
.BR http://gtkballs.antex.ru
|
|
.SH AUTHORS
|
|
.BR GtkBalls
|
|
was created by Eugene Morozov <jmv@online.ru>.
|
|
This manual page was created by Christoph Thompson <obituary@freshmeat.net>.
|
|
Current maintainer of
|
|
.BR GtkBalls
|
|
and this manual page is drF_ckoff
|
|
<dfo@antex.ru>.
|
|
.SH COPYRIGHT
|
|
.BR GtkBalls
|
|
is copyright 1998, 1999 Eugene V. Morozov under the terms of the GNU
|
|
General Public License.
|
|
.BR GtkBalls
|
|
is free software; you can redistribute it and/or modify it under the terms
|
|
of the GNU General Public License as published by the Free Software
|
|
Foundation; either version 2 of the license, or (at your option) any
|
|
later version.
|