Instructions for building and installing qnetdp
------------------------------------------------------------------------------
------------------------------------------------------------------------------

Requirements
- Linux (tested with openSUSE 11.0, 11.1)
- GNU C++ compiler (tested with version 4.3.1)
- GNU make

Step 0. Unpack archive
----------------------------------

Use your favorite tools to unpack the gzipped tar file containing the source.
For example

	zcat qnetdp-1.0.tar.gz | tar xvf -
 
Step 1. Edit top-level Makefile
----------------------------------

Change directory into the top-level directory.  If you've just unpacked the
archive then

	cd qnetdp-1.0

should put you in the right place.  Begin by editing Makefile.  You'll need to
check at least one variable and make sure it is set correctly for your
system.

    PREFIX    - This is necessary if you want to install qnetdp so other users
		can use it as well.  PREFIX should be assigned a top-level
		directory that has the $PREFIX/bin and $PREFIX/man
		subdirectories.  $PREFIX/bin should be in user's PATH variable
		and $PREFIX/man should be a directory that the man program
		will search or be stored in the MANPATH variable.

Step 2. Make
----------------------------------

Type "make" to build the library and executable.  The qnetdp program will be
built in the src subdirectory.  You can run them from there or install them.

Step 3. Install
----------------------------------

If you have access to the root account, you can install the program on your
system.  This is done with "make install" as root, or "sudo make install" as
regular user.

Should you want to remove the programs, return to the qnetdp top-level
directory and type "make uninstall" (or "sudo make uninstall").

Step 4. Clean up
----------------------------------

Type "make clean" to remove object files.  Type "make clobber" to remove both
object files and executable (don't do this unless you have already installed
the programs).

Problems?
----------------------------------

If you have problems installing or using this software, please contact
Jonathan Senning <jonathan.senning@gordon.edu>.
