Installing gophervr
-------------------

GopherVR is currently tested on Mac OS X 10.4-10.6 (PowerPC and Intel),
SGI Irix 6.5 (MIPS), Arch Linux (x86) and Ubuntu 10.04 (x86).

1) First make sure you have a version of Motif available.  This comes
   with most standard commercial unix systems.  For Linux you can
   use Lesstif (http://www.lesstif.org) without any trouble.  Most Linux
   distributions have it or can get it. Irix has Motif built-in. For OS X, use 

	http://www.ist-inc.com/DOWNLOADS/motif_download.html

   [the 10.5 version works fine on 10.6]).

2) Make sure you have a complete build environment.  That means
   installing any development packages that you may need.  For example, on
   Linux you might need to install XFree86-devel (for xmkmf) and
   lesstif-devel (for the header files); Ubuntu users should install all the
   compiler and printing packages, and your header files.

   For Mac OS X, you need Xcode 2.5 or higher with xcodebuild, and X11.app 
   (separate install for 10.4, included in 10.5 on up). Audio is not yet
   supported.

   ** FOR 10.6 AND HIGHER **
   When running GopherVR on 10.6+, use either the original X11.app or older
   XQuartz (2.6.0 is known to work); recent XQuartzes break detection of
   a held-down mouse button in the window and make it difficult to move. This
   is a known problem but there is no fix yet. If XQuartz launches instead of
   X11, you may need to temporarily remove it from your system.

   For Irix 6.5, you need MIPSPro 7.4.4m and associated development headers.
   gcc is not yet supported for Irix. Some features don't work yet on Irix,
   including help and audio.

3) Next type 'make' followed by your architecture.  The following systems are
   recognized (but not necessarily tested):

     macosx11   - Mac OS X 10.4+ (Universal binary)
     linux      - most versions of Linux (only tested on x86/x86_64)
     irix       - Irix 6.5 (6.5.10+ tested)

     These targets are untested and/or experimental.
     cygwin     - Cygwin 1.7+ with gcc and Motif/dev packages
     sol2sparc  - Sun Solaris running a sparc CPU
     sun4       - SunOS 4.x
     irix5      - Irix 5.x

6) Once everything is compiled go into the 2nd level gophervr
   directory and type ./gophervr (or if you're on a Mac, grab the binary out
   of motifmaclauncher/build/).

   On Linux, copy gophervr.help to /usr/share/doc/gophervr/gophervr.help.

   You may want to copy the futura.hfont to /usr/local/lib if you plan to
   install the gophervr binary.

Enjoy!

