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

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

  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

      I would be real interested in updates here as I no longer have
      access.

    win32/Makefile (MinGW gcc only):
      You may want to set parameters in Makefile for target triplet.

      cd win32
      make

      Then run "wmball".  You are on your own on installing the
      wmball.ini file and mball.scores file.

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

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

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

  X users only:

    The following installation option is run during when you use the configure
    "make install".

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


    This is used for CDE:

    make install-xpm:
      This is used to install the "mball.?.xpm" images for use with menus
      in CDE using system files (name changes from ".xpm" to ".pm" when
      installing).

    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.
