ABOUT THIS README FILE

This README file contains information related to the distribution of
the 97.0430 version of the Xgrav software package.

			ABOUT THIS DISTRIBUTION

This is a "minimalist" distribution which will evolve over time.  The
motivation for putting this out now is to provide interested
investigators with something with which to work.

The ususal provisos that accompany freely distributed software apply
here as well, such as:  1. The author is not responsible for any
problems you might experience using it and 2.  Don't sell it, or
incorporate it into a commercial product.

This distribution was put together by Steve Roecker
(roecker@harold.geo.rpi.edu).

		   HOW TO RETRIEVE THIS DISTRIBUTION

The contents of this distribution are stored in a compressed tarfile
called Xgrav_0497.tar.Z, and resides in the anonymous ftp area
of harold.geo.rpi.edu (128.113.15.10) in the pub/Programs directory.
It can be retrieved either by anonymous ftp to harold.geo.rpi.edu or
through the RPI Geophysics Software web page:

	http://gretchen.geo.rpi.edu/software.html

Follow the directions on this page for ftping the Xgrav package.

			    WHAT'S HERE

An economical way to extract the contents of the tarfile is to issue
the command:

	zcat Xgrav_0497.tar.Z | tar xvf -

The contents, placed in a subdirectory called "Xgrav", are:

README.0497 	This file

bin/          	Executable compiled on a Sun Sparcstation LX.  You
		can try this and see if it works for you to avoid the
		trouble of having to "remake" it.  

doc/            Documentation of the software, in this case an
		HTML files that was developed using a NetScape 2.0
		browser.

src/		Contains all the source code.

				INSTALLATION

The src directory contains all the code for the following program:

Xgrav	The interactive gravity modelling software


An executable is included in the bin directory, but of course it may
not run on your computer or you may want to modify the code.

Before compiling Xgrav, edit the pathnames in the Makefile to correspond
to the proper directories for xview, FORTRAN, and openwindow
libraries.

To compile, go into the src directory and look for the Makefile.  To
compile Xgrav, simply type:

		make

and return.  After compilation, the executable resides in the src
directory.  If you wish to move it to another directory, edit the
BIN_DIR variable in the Makefile so that it has the proper directory
name (the default is Xgrav/bin) and then type:

		make install

			   DOCUMENTATION

Documentation is scant by improving.  At the moment an HTML file
discussing Xgrav is included in the "doc" directory.  This is available
over the Web as well (via http://gretchen.geo.rpi.edu/software.html)

			    EXAMPLES

Well, not yet.  Maybe next time.  Some examples are discussed in the
manual, however.