⟦d159d74e5⟧

TextFile

.TH DRAGON 1 "18 April 1989" "X Version 11R3"
.SH NAME
dragon \- Mah-Jongg game
.SH SYNOPSIS
.B dragon
[-cursor name]
[-double interval]
[-icongeometry geometry]
[-/+iconic]
[-iconname name]
[-geometry geometry]
[-/+reverse]
[-/+shadows]
[-sides type]
[-/+sticky]
.SH DESCRIPTION
\fIDragon\fP plays a version of the game of Mah-Jongg.

Mah-Jongg is played with a set of tiles.  The tiles are set out in a
particular pattern and the object of the game is to eliminate all of
the tiles.  \fIDragon\fP plays with the tile pattern known as "The
Dragon".  This pattern has 5 levels of tiles.  From above, this
pattern somewhat resembles a sleeping dragon.

Tiles are removed from the game two at a time.  The two tiles removed
must "match" and they must both be "free".

A tile is "free" if on the left or on the right side there is no tile
that is on the same stacking level as this tile.  There may be tiles
that are at a lower level than this tile but not one at the same or
higher level.  To select a free tile for removal just click on it.
\fIDragon\fP will refuse to select a tile that is not free.  To remove
a pair of tiles simply double-click on one of the tiles.  You have the
option of selecting one tile and then double-clicking on the second or
else selecting both tiles and then double-clicking upon either tile.

Two tiles match if a) they both have the same picture upon their
faces, b) they are both flowers, or c) if they are both seasons.

There are seven types of tile.

Flowers - There are four tiles that represent flowers.  These are the
Orchid, the Plum, the Mum, and the Bamboo tiles.  Any two flowers match.

Seasons - There are four tiles that represent the four seasons.  These
are the Spring, Summer, Autumn, and Winter tiles.  Any two seasons match.

Dragons - There are three types of dragons and there are four each of
the dragons.  There is the Red dragon, the White dragon, and the Green
dragon.  Only two dragons of the same type match each other.

Winds - There are four each of the four winds.  These are the East,
West, North, and South tiles.  Only two winds from the same direction
match each other.

Bams, Dots, and Craks - These tiles are numbered 1 through 9.  There
are four each of each numbered tile.  Only two tiles of the same type
with the same number match each other.

.SH OPTIONS
The \fIdragon\fP program accepts all of the standard X Toolkit command
line options along with the additional options listed below:
.TP 8
.B \-help
This produces a verbose message describing the command line options.
.TP 8
.B \-cursor name
Normally \fIdragon\fP uses the "hand2" cursor.  Use this option to
use your favorite cursor instead.
.TP 8
.B \-double interval
In order to play the game you must double-click upon tiles.  This
option allows you to set the maximum time interval between clicks that
separate the two clicks that make up a double click.  The default is
250 milliseconds.  Clicks further apart than this will be treated as
separate single clicks instead of one double click.
.TP 8
.B \-geometry geometry
Use this option to specify the geometry to be used for the
\fIdragon\fP window.  There are five sizes that \fIdragon\fP prefers,
450x340, 650x500, 870x660, 1080x820, and 1290x980.
.TP 8
.B \-icongeometry geometry
Use this option to specify the geometry to be used for the
\fIdragon\fP icon.  There are two sizes that \fIdragon\fP prefers,
32x32 and 64x64.
.TP 8
.B \-iconic
Use this option and \fIdragon\fP will first appear as an icon.  Use
the \fB+iconic\fP form and \fIdragon\fP will \fBnot\fP first appear as
an icon.
.TP 8
.B \-iconname name
Use this option to set the name of \fIdragon's\fP icon.
.TP 8
.B \-reverse
Use this option for reverse-video and use the \fB+reverse\fP option
for normal-video.
.TP 8
.B \-shadows
Use this option and tiles will not have 3-D shadows and use
the \fB+shadows\fP and tiles will have (the default) 3-D shadows.
.TP 8
.B \-sides type
This option can be used to specify the way that tile sides are drawn.
There are four possiblities.  "gray" (the default), "black", and "line".
.TP 8
.B \-sticky
By default, the first selection is "sticky" (+sticky) which means that
attempts to select a second tile that is free but which doesn't match
the first are rejected.  If the first selection is not sticky
(-sticky), an attempt to select a free tile that doesn't match the first
will deselect the first tile and leave only the second selected.
.SH MOUSE BUTTONS
Click button 1 on any tile to select it.  Click on any menu button to activate
it.

Click button 2 to obtain a (next) hint on a possible move.  See the Hint menu
button below for more information.

Click button 3 to remove two selected tiles from the game.
.SH MENU BUTTONS
There are several buttons visible in \fIdragon's\fP window and there
are two sets of buttons.  The inital set includes:
.TP 8
.B "New Game"
Press this button to reshuffle the tiles and start a new game.
.TP 8
.B "Restart"
Press this button to restart the current game.  This gives you a
chance to try again.
.TP 8
.B "Save"
Press this button to save the current game into the file
$HOME/.dragon-save.  The current game is saved at the current point
for later resumption.
.TP 8
.B "Other"
Press this button to get to the other set of buttons.
.TP 8
.B "Hint"
This button can be used in two ways.  First, if you are stuck for a
move then just press this button repeatedly and \fIdragon\fP will show
successive possible moves.  Of course, there may not be any.  Second,
if you want to remove a particular tile but you cannot see any
matching free tiles then select the tile and then press this button to
see if \fIdragon\fP agrees with you that there aren't any matching
free tiles.
.TP 8
.B "Restore"
Press this button to read the $HOME/.dragon-save file and to resume a
saved game.
.TP 8
.B "Quit"
Press this button to exit the game.
.PP
The other set of buttons include:
.TP 8
.B "Redraw"
Press this to cause the board to be redrawn.
.TP 8
.B "Sides"
Press this repeatedly to cycle through the available set of drawing
options for the tiles.
.TP8
.B "Samples"
Press this to display the full set of tiles.  Press it again to get back to
the game.
.TP 8
.B "Other"
Press this to get back to the first set of buttons.
.TP 8
.B "Cheat"
Press this button to toggle Cheating mode.  When this is turned on you
can remove any two arbitrary tiles.  Don't cheat!
.TP 8
.B "Sync"
Press this button to turn on synchronous mode.  This makes
\fIdragon\fP synchronize everything with the X Server; it is typically
used only for debugging.
.SH "X DEFAULTS"
\fIDragon's\fP name is usually "dragon" and its class is "Dragon".  It
understands all of the core X Toolkit resource names and classes as
well as:
.TP 8
.B "cursor (\fPclass\fB Cursor)"
Specifies the name of the cursor to use.  The default is "hand2".
.TP 8
.B "doubleClick (\fPclass\fB DoubleClick)"
Specifies the maximum time to allow between the two clicks that form a
double-click.  The default is 250.
.TP 8
.B "geometry (\fPclass\fB Geometry)"
Use this option to specify the geometry to be used for the
\fIdragon\fP window.  There are five sizes that \fIdragon\fP prefers,
450x340, 650x500, 870x660, 1080x820, and 1290x980.  The default is
"450x340".
.TP 8
.B "iconGeometry (\fPclass\fB IconGeometry)"
Specifies the geometry of the \fIdragon\fB icon.  Preferred sizes are
32x32 and 64x64.  The default is "64x64".
.TP 8
.B "iconic (\fPclass\fB Iconic)"
Specifies TRUE to cause an iconic startup and FALSE for a normal
startup.  The default is FALSE.
.TP 8
.B "iconName (\fPclass\fB IconName)"
Specifies the name for the icon.  The default is NULL.
.TP 8
.B "reverseVideo (\fPclass\fB ReverseVideo)"
Specifies TRUE for reverse-video effects and FALSE for normal-video.
The default is FALSE.
.TP 8
.B "stickyTile \(fPclass\fB StickyTile)|
Specify TRUE for first tile selected to be sticky (default), FALSE for
selection follows click.
.TP 8
.B "tileShadows (\fPclass\fB TileShadows)"
Specifies TRUE if tiles are to have 3-D shadows and FALSE if not.  The
default is TRUE.
.TP 8
.B "tileSides (\fPclass\fB TileSides)"
Specifies the type of sides to use when drawing tiles.  The default is
"gray" for gray sides.  The other options are "black" for black sides
and "line" for sides with lines.
.SH "SEE ALSO"
X(1)
.SH BUGS
.LP
No known bugs.  Send bug reports to geb@rational.com.
.SH COPYRIGHT
None; have fun.
.SH AUTHOR
Gary E. Barnes (Rational; geb@rational.com)
.br
DataMuseum.dk

DKUUG/EUUG Conference tapes

⟦d159d74e5⟧ TextFile

Derivation

TextFile
