README:

Copyrights:

- see the README file in "etc/primer/README".  Specifically, we reserve
  the right of co-authorship for any publication in which 3-body
  scattering programs are used (in src/dyn/scatter3), in the same spirit
  as discussed in etc/primer/README under item 3.
                                                   Piet and Steve, March 1994.

To install Starlab:

- Create a new directory somewhere in your own directory tree.  We 
  suggest the name "starlab", but that is not necessary--any name
  will do. In this directory, create a subdirectory to identify the
  version that you are using.  We suggest that you use as a directory
  name the particular version you are going to copy (e.g. "1.1.1" if
  you will copy Starlab 1.1.1), but any name will do.  You can create
  several subdirectories, each of which can contain a complete Starlab
  version, totally independent of the others.  For example, you can
  have directories "starlab/1.0", "starlab/1.1", "starlab/1.1.1", etc.

- Copy (or ftp) the most recent Starlab tar file, of the form 
  "yymmddhh.s_tar_lab_version_0", from the main Starlab directory to
  the private "starlab/version" directory that you have just created.
  The (compressed) "_1" and "_2" versions of the tar file contain
  additional user-written material (including versions of Aarseth's
  N-body codes in forms that work in the Starlab environment). To find
  out how to use them, consult an experienced user.

- Untar the tar file by giving the command:

	tar xvf yymmddhh.s_tar_lab_version_0

  NOTE: The versions are now REQUIRED by some Starlab software.
	Do NOT unbundle the tar file in the "starlab" directory itself.

- Make a subdirectory "starlab/version/local" and copy the files
  contained in "starlab/version/templates", currently:

	"starlab/version/templates/starlab_setup"
	"starlab/version/templates/cshrc.starlab"
	"starlab/version/templates/Makefile.local.inc"

  into it.  That is, issue the command:

	cd starlab/version ; cp templates/* local

  These files are your local copies of the Starlab setup files that
  will never be accidentally overwritten by untarring a new new Starlab
  archive. As distributed, they are appropriate for use on a Sun
  SPARCStation. On other systems, you will probably have to modify your
  copies of cshrc.starlab and Makefile.local.inc by commenting or
  uncommenting some of the lines in them. Ask a Starlab expert how to
  do this if it isn't obvious.

- To set up the Starlab environment, include the following lines in
  your .cshrc file:

     setenv STARLAB_PATH <starlab-directory-name>
     source $STARLAB_PATH/local/starlab_setup

  For example, for starlab version 1.0, use:
  
     setenv STARLAB_PATH ~/my_starlab/1.0
     source $STARLAB_PATH/local/starlab_setup

  The file starlab_setup MUST be sourced from .cshrc, not .login, in order
  for the starlab environment to be visible during the "make" process.
  A sample file containing a slightly fancier setup may be found in:

	$STARLAB_PATH/templates/cshrc.add-on

- If your search path is set in .cshrc (before invoking starlab_setup),
  then you need do nothing more: Starlab will set your path correctly.
  If your path is set up in .login (or anywhere after starlab_setup
  is used), you must add Starlab to your path afterwards as follows:

	set path = ($path $STARLAB_PATH/bin $STARLAB_PATH/sbin)
	rehash

- Finally, enter the command "source .cshrc", or log out and log in
  again, and you are ready to go!  To build Starlab, type

	cd $STARLAB_PATH
	make all
	rehash

- For further information, see  "starlab/version/etc/primer/README"