	X-BASED PANEX(tm)
	=============	Panex X widget, V5.3


    It has been tested on the following platforms:

	Sun4, SPARC		SunOS 4.1.3	X11R4
	Sun4, SPARC		SunOS 5.4	X11R5
	PC, 486 		Linux 1.2.13	X11R6

    If yours is not in this list, please let me know -- thanks. The
    most updated source could be found on ftp.x.org under
    /contrib/applications.

HOW TO BUILD?

    Do you have Motif?  If so, uncomment line 28 of Imakefile.

    To build, it should be easy.

	xmkmf
	make
	xpanex  [motif version will be xmpanex]

    Note: if you don't have 'xmkmf' or the "Makefile" it generates
    does not work well, edit Makefile.std for appropriate settings for
    XINCLUDEPATH and XLIBPATH, then try:
	make -f Makefile.std
	xpanex

    or if you have Motif, uncomment appropriate sections, then try:
	make -f Makefile.std all.xm
	xmpanex

    You should have Panex.ad copied to $(HOME)/Panex or 
    /usr/lib/X11/app-defaults/Panex to run, especially if the background
    is similar to the tiles. Edit this file for your preferences.  For
    monochrome, the tile color needs to be brighter.  You might want to
    move xpanex into /usr/bin/X11 (or wherever your X binaries are).
    You might also want to move xpanex.man to /usr/man/man1/xpanex.1

ANYTHING SPECIAL IN USING?

    Click on the left mouse button to move the top tile in a column.
      Release it on another column.  It will not move if blocked.
    Double click on the right mouse button if you want to reset the puzzle.
      Also 'R' or 'r' do the same thing.
    'M' or 'm' to toggle between hanoi (one pyramid column) and panex (two
      pyramid columns) modes.  They each have different rules.
      Hanoi one can not place larger trapazoid on a smaller trapazoid.
        Here the goal is to move the pile from the left peg to the rightmost
        peg.
      Panex a tile can not go lower that its initial starting point.
        Here the goal is to exchange the 2 piles.
    'S' or 's' to auto-solve.  Unfortunately, its only implemented for
      hanoi mode from starting position.
    'U' or 'u' to undo last move.
    'G' or 'g' to get a saved puzzle.
    'W' or 'w' to write or save a puzzle.
    'Q', 'q', or Control-C to kill program.

    The title is in the following format:
  w{hanoi | panex}: <int> @ (<Number of moves>/\
    {<Record number of moves>|NEVER}) - <Comment>
    <int>: rows.
    {<Record...}: if there is no record of the current puzzle, it
       displays "NEVER".
 
    Keep in mind that the Panex 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.

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

SAVE FORMAT
 
    The format is not standard.  The reason is that this is simple to
    produce and I do not know what the standard is.  The format will
    probably change to become more readable.
 
    mode: 0 hanoi, 1 panex
    tiles: number of tiles in a column
    moves: 0-MAXINT
 
    startingPosition: array pairs of column and position of each tile
 
    This is then followed by the moves
    move #: from_column  to_column
    from_column is the top tile of the column
    to_column is where that tile is moved to.

    Caution: the program may crash on corrupted input.

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 the problems with my limited resources.

	David Albert Bagley,	bagleyd@hertz.njit.edu

HISTORY

  [Apr 22, 96]	V5.3: Written.
