Installation Instructions
*************************

Basic Installation
==================

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

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

      cd win32
      make

  Windows users only:
    Then run "wpyraminx".  Your on your own on installing the
    wpyraminx.ini file and pyraminx.scores file.

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

    You should copy Pyraminx.ad to $(HOME)/Pyraminx or use "make install"
    to copy it to something like /usr/lib/X11/app-defaults/Pyraminx.  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 pyraminx.scores should be writable by the application but not
      users.  It will try to fallback to reading and writing in the current
      directory.  (pyraminx.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.

Optional Features
=================

  X users only:

    The following installation options are used after you used one of the
    above configure installs.

    make install-png:
      This is used to install the "*.pyraminx.png" images for use with menus
      in Gnome and KDE.

    make install-xpm:
      This is used to install the "pyraminx.?.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.
