  X-BASED THREED
  ============== Threed X widget, V5.7

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   WindowsXP/Cygwin
    IBM PowerPC     AIX 4.3.3.0

  Previous versions tested on:
    Sun SPARC       SunOS 5.4
    Sun SPARC       SunOS 4.1.3
    PC  Pentium     Linux 1.0.9
    PC  486         Linux 1.2.8

  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 3 types.  You may want to set some
    parameters like DATAFILE.

    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 distributer ... i.e. not
      my fault.  You may want to set the DATAFILE in Imakefile .
      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 some parameters in make.com .

      @make

  Then just run "xthreed".  If you do a "make install" "DATAFILE" must be
  set correctly.

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

  Try resizing Threed.  Notice the image resizes to take advantage of
  the "room" available.

  Keep in mind that Threed 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.

FILE FORMAT
 
  The format is pretty standard.  I got it mostly from PHIGS.  I added
  a few things.  The "threed.comm" file has some comments that may help
  in understanding the "threed.dat", thats the only reason it is
  included.  The program will crash if data file is corrupted.  Please
  note that the ordering of the data matters.

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

  [Aug 28, 2003]  V5.7.2:
    Added some installation options
  [Jul 07, 2003]  V5.7.2:
    Reorganized installation.
  [Jul 07, 2003]  V5.7:
    'Esc' will hide the puzzle (actually osfCancel did the trick)
  [Mar 21, 2003]  V5.6.2:
    Installation fixes for Motif and X versions.
    configure if around 2nd AC_CHECK_FUNC
    removed Sun CC (char *) warnings
    removed hard coding of program name
    Cygwin changes ./, -lSM -lICE
    allow more arrow keys (osf)
    handed some nulls from core dumping
    fixed up sliders not to give warnings
  [Dec 15, 95]	V5.1: Minor updates, finally got around to publicly
    releasing it..
  [Oct 02, 95]	V5.0: Xt/Motif.
  [Nov 11, 94]	V4.0: Xt version.
  [May 17, 93]	V3.0: Motif version.
    I got some good ideas from Douglas A. Young's book:
    "The X Window System Programming and Applications with
    Xt OSF/Motif Edition", particularly his dial widget.
    I got some good ideas on presentation from Q. Zhao's
    tetris.
  [May 14, 93]	V2.0: XView version.
  [Mar 01, 93]	V1.0: MS Windows by Thomas W. Olsen "The C Users Journal"
    pp 53-61.
