  X-BASED BARREL
  ============== Barrel X widget, V7.1.3

Primary site: ftp://ftp.tux.org/pub/tux/bagleyd/xpuzzles
Secondary site: ftp://ibiblio.org/pub/Linux/games/strategy
Web page: http://www.tux.org/~bagleyd/puzzles.html
Maintainer: David A. Bagley <bagleyd@tux.org>

  It has been tested on the following platforms:
    Sun Ultra 5     SunOS 5.8
    PC  Pentium 4   Linux 2.4.18
    PC  Pentium 4   Windows XP Cygwin X11R6
    PC  Pentium 2   Windows 2000 Cygwin X11R6
    IBM PowerPC     AIX 4.3.3.0
    PC  Pentium 4   Windows XP Mingw*
    PC  Pentium 2   Windows 2000 Mingw*
 * Unresolved ACCELERATORS bug see HISTORY at bottom.

  If you have to do any editing to get this to work, please mail me
  the changes.

HOW TO BUILD?

  An ANSI C compiler is required for build.

  To build, it should be easy.  There are 4 types.  You may want to set some
    parameters like SCOREPATH, SCOREFILE, LOGPATH, and LOGFILE.

    configure:
      Use "configure -help" to see what options you can set using configure
      or parameters in Makefile.in .

      configure ; make

    imake:
      Sometimes this is not setup correctly by the distributor ... i.e. not
      my fault.  You may want to set parameters in Imakefile .
      If you have Xpm you may want to do this quick edit in the Imakefile:
        Uncomment line "#define XpmLibrary".
      If you have Motif you may want to do this quick edit in the Imakefile:
        Uncomment line "#define XmLibrary".

      xmkmf ; make

    make.com (VMS users only):
      You may want to set parameters in make.com .

      @make

    win/Makefile (Mingw users only):
      You may want to set parameters in Makefile (like
      COPT=-02 -mno-cygwin).

      cd win
      make

      Then run "wbarrel".  Your on your own on installing the wbarrel.ini
      file and barrel.scores file.

X users only:
  Then just run "xbarrel".  If you do a "make install" "SCOREPATH" and
  "LOGPATH" must be set correctly.

  You should copy Barrel.ad to $(HOME)/Barrel or use "make install" to
  copy it to something like /usr/lib/X11/app-defaults/Barrel.  Edit
  this file for your preferences.

  There are a few install options using configure.
  make install:
    Normal installation usually in /usr/local.  The problem is that the
    file barrel.scores should be writable by the application but not
    users.  It will try to fallback to reading and writing in the current
    directory.  (barrel.log is a temporary log file to keep track of
    moves, here the current directory is the default with /usr/tmp as the
    fallback).
  make install-games:
    This will install the puzzle like the BSD games.  This configuration
    is for the most part hard coded and will ignore most prefix settings.
    The difference here is that it runs setgid.  This then has some
    "medium" security risks.

  The following installation options are used when the above ones are working.
  make install-png:
    This is used to install the "*.barrel.png" images for use with menus
    in Gnome and KDE.
  make install-xpm:
    This is used to install the "barrel.?.xpm" images for use with menus
    in CDE using system files (name changes from ".xpm" to ".pm" when
    installing).  The xpm images are the same the png images except the small
    image is 24x24 instead of 22x22.
  make install-xpm-home:
    This is used to install the images for use with menus in CDE using
    from your home directory.  I have this set up using the desktop and
    menus.  There are probably many ways but I have it set up using
    $HOME/.dt/types/dtfile.dt, $HOME/.dt/types/dtwm.fp, and $HOME/.dt/dtwmrc
    These files can be copied and changed from /usr/dt.
  Try resizing the puzzle.  Notice the puzzle resizes to take advantage of
  the "room" available.

  Monochrome users may have to run it with -tile Black or -tile White.
  or with -fg White or -fg Black.  Whatever works for you.

  I chose to display the puzzle horizontally because if I ever decide
  to implement the auto-solver, it will be easier because the IDEAL
  solution book shows it that way.

  Keep in mind that the puzzle portion is a widget that can be simply stuck
  in other X programs. (If you find a use for this, let me know).

  Refer to the man page for detailed command line options and instructions
  on how to operate.

  If you want further information on puzzles, I'll be glad :-) to send
  it to you.

FOUND A BUG?

  Send bugs reports and fixes to the author. For bugs, please include
  as much information as to their location as possible, since I may not
  be able to duplicate them.

HISTORY

  [Feb 8, 2005]  V7.1.3:
    Mouse wheel for Windows now works.
    Rotating now mouse motion sensitive.
    Small graphical fixes.
  [Nov 21, 2004]  V7.1.2:
    Small changes synchronizing with Java code.
    Thanks to Debian maintainer Florian Ernst <florian@uni-hd.de> for
      esound fix.
  [Sep 25, 2004]  V7.1.1:
    Better speed control with "<" and ">".
    Installation of sound and mandrill files.
  [Aug 23, 2004]  V7.1:
    Thanks to Debian maintainer Florian Ernst <florian@uni-hd.de> for
      fixing a compilation problem with X and without Motif.
       Better double buffering.
    Added font option.
    Picture option added, many ideas including the mandrill were
      borrowed from X puzzle by Don Bennett, HP Labs.
    Sound added.
    Sort of real time using getttimeofday.
  [Dec 15, 2003]  V7.0.1:
    The Hide functionality of the Escape key now iconifies or drops in
      task bar.
    Mono fix.
    Animate rotate ported to Windows.
    Added help in Windows.
    Accelerator Keys (F keys and regular keys) in Windows now work.
    Todo: needs an auto-solve.
  [Oct 21, 2003]  V7.0:
    New puzzle: first version based on xmlink...
