NAME

       wmpuzzle - WindowMaker dock app 4x4 puzzle

SYNOPSIS

       wmpuzzle [options] [xpm image file]

DESCRIPTION

       wmpuzzle 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.

OPTIONS

       -h, --help
              displays a command line summary.

       -a, --auto-save
              automatically save the puzzle state on program exit.

       -k, --keyboard
              enable use of the keyboard for arrow-key navigation.

       -s, --shuffle=count
              shuffle  the  image count times, defaults to 2000.  Using -s prevents loading the saved state from
              the resource file.

       -v, --version
              displays the version number.

       --display=id
              Set the display to use, e.g. --display=:0.0.

       --geometry=pos
              Set the position of the dock app, e.g. --geometry=+10+10. Note that the size (64x64) is hard-coded
              and cannot be changed.

       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.

USAGE

       Left  mouse  click  moves the puzzle tiles, right click saves the current state and middle click recovers
       the last saved state. If -k has been specified the arrow keys and key s and key r will do as well.

       If the picture has been completed the last element will be shown.

FILES

       ~/.wmpuzzlerc
              contains the puzzling state of the images. The basename of an image  file  will  be  used  as  its
              identifier. Use option -s to ignore this file on startup.

BUGS

       When  wmpuzzle complains about not enough free color symbols 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.

       Please  send  any bugs to <martin@godisch.de>. Debian users are encouraged to use the Debian Bug Tracking
       System at http://bugs.debian.org/wmpuzzle.

AUTHOR

       wmpuzzle 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.

The Debian Project                                  June 2013                                        wmpuzzle(6)