.\" wmpuzzle.6.  Generated from wmpuzzle.6.in by configure.
.\" vim: set et:
.\"
.\" Copyright (c) 2002-2013 Martin A. Godisch <martin@godisch.de>
.
.TH wmpuzzle 6 "June 2013" "The Debian Project" "Version 0.5.2"
.
.SH NAME
wmpuzzle \- WindowMaker dock app 4x4 puzzle
.
.SH SYNOPSIS
.B wmpuzzle
.RI [ options ]\ [ xpm\ image\ file ]
.
.SH DESCRIPTION
.PP
\fBwmpuzzle\fP provides a 4x4 puzzle on a 64x64 mini window.
It is designed to work with the WindowMaker dock, but will
work with other window managers as well.
.
.SH OPTIONS
.TP
\fB\-h\fP, \fB\-\-help\fP
displays a command line summary.
.TP
\fB\-a\fP, \fB\-\-auto\-save\fP
automatically save the puzzle state on program exit.
.TP
\fB\-k\fP, \fB\-\-keyboard\fP
enable use of the keyboard for arrow-key navigation.
.TP
\fB\-s\fP, \fB\-\-shuffle=\fIcount\fP
shuffle the image \fIcount\fP times, defaults to 2000.
Using \fB\-s\fP prevents loading the saved state from the resource file.
.TP
\fB\-v\fP, \fB\-\-version\fP
displays the version number.
.TP
.BI \-\-display= id
Set the display to use, e.g. \-\-display=\fI:0.0\fP.
.TP
.BI \-\-geometry= pos
Set the position of the dock app, e.g. \-\-geometry=\fI+10+10\fP. Note that
the size (64x64) is hard-coded and cannot be changed.
.PP
The image file must be an XPM file with minimum (and recommended) size of
48x48 pixels. If it is larger then the upper left corner will be shown.
.
.SH USAGE
.PP
Left mouse click moves the puzzle tiles, right click saves the current
state and middle click recovers the last saved state. If \fB\-k\fP has been
specified the arrow keys and key \fIs\fP and key \fIr\fP will do as well.
.PP
If the picture has been completed the last element will be shown.
.
.SH FILES
.TP
~/.wmpuzzlerc
contains the puzzling state of the images. The basename of an image file
will be used as its identifier. Use option \fB\-s\fP to ignore this file on
startup.
.
.SH BUGS
.PP
When \fBwmpuzzle\fP complains about \fInot enough free color symbols\fP
that's because it needs to add six colors to the XPM's color table and
found no free symbols using the according number of characters per pixel.
Try to find some unused entries, delete them and correct the size of
the color table (the third number in the first line), or enlarge the
number of characters per pixel using some imaging program.
.PP
Please send any bugs to <martin@godisch.de>. Debian users are encouraged
to use the Debian Bug Tracking System at
.IR http://bugs.debian.org/wmpuzzle .
.
.SH AUTHOR
.PP
\fBwmpuzzle\fP is written by Martin A. Godisch <martin@godisch.de>. Thanks to
Gordon Fraser for his suggestions, and to Kyle Boyle for the contribution of
his numbers puzzle. Thanks to Matthias Klose for bug reports and fixes.