README for Backfract 1.0.0 by William Shubert, 30 November 1997
---------------------------------------------------------------
   Backfract is an "animated wallpaper". It runs on Unix systems with X11. It
will draw a Mandelbrot fractal over your background window, and replace the
fractal every minute by either zooming in or out.
   I can be contacted through email at "wms@hevanet.com", or you can visit
my web page at "http://www.hevanet.com/wms/".

HOW TO BUILD
------------
   Backfract uses the Gnu autoconf utility.  To build and run it, follow these
steps:

1) Unpack it.  You must have done this already to read this file.  Make sure
   that you "cd" into the backfract directory (the directory that has this
   README in it).
2) Type "./configure".
3) Type "make".
4) Type "backfract".  If all went well you should be running backfract.
   When your run backfract, it prints out it's PID and returns the shell to
   you. It will now run in the background indefinitely. To stop backfract,
   you must type "kill <pid>" where <pid> is what backfract originally
   printed out.

   Backfract will automatically "nice" itself to run at a lower priority than
   other applications. Do not worry about it taking up too much CPU time.

   Running "backfract -help" will list the options available.

INSTALLING
----------
   backfract's build directories (that is, the directory that has this README
in it and all the subdirectories) take up a lot of disk space.  After you
build it, you need nothing but the binary.  You can install it by running
"make install" in the build directory; if you want to put it somewhere
besides "/usr/games/bin", then you should edit the Makefile, set "PREFIX"
to the place to put backfract, then run "make install".  After you've installed
the binary, feel free to delete everything else.

IF YOU HAVE TROUBLE
-------------------
   The section below this lists some systems that are known to have trouble
building.  Check there to see if your system is on the list.
   The most common problem is systems that need special switches to run "cc".
Your C compiler MUST be an ansi-compatible c compiler.  If you have trouble
with "./configure" or if you have trouble compiling, try setting your
environment variable "CC" to be how to run your C compiler.  For example,
on some HP/UX systems "make" will break unless you set "CC" to be
"cc -Aa -D_HPUX_SOURCE".  On a csh-based system, you set this with:
  $ setenv CC "cc -Aa -D_HPUX_SOURCE"
and on an sh-based system you need to type two lines:
  $ CC="cc -Aa -D_HPUX_SOURCE"
  $ export CC
After setting CC, run "./configure" again and then "make" again to see if it
works better.
   Another problem is finding the X11 includes and/or libraries.  If they
aren't founds when you are compiling, try running configure again, but
this time try "./configure --x-includes=<DIR> --x-libraries=<DIR>" to
tell configure where your X includes and X libraries are.

KNOWN PROBLEM SYSTEMS
---------------------
HP/UX
   Needs CC set as above, and sometimes needs the X directory set
by hand (also as shown above).
