====
RNACAD INSTALL
====

RNACAD should install and run on most UNIX machines. It goes require
some common tools like perl, gawk, sort, rm, ... which usually come
installed with most UNIX distributions.

To install RNACAD:

   1. Get the tar gziped package rnacad-1.1.1.tar.gz and put it in a
      directory.
   
   2. Uncompress it: gunzip rnacad-1.1.1.tar.gz

   3. Untar it: tar xvf rnacad-1.1.1.tar.gz

   4. Go into the new directory: cd rnacad-1.1.1

   5. Make the package: make 

   6. Make sure your path includes the executable programs left in the
      bin directory. You can do this by adding the
      <installDirectory>/rnacad-1.1.1/bin directory to your path or
      moving the files in the bin directory to a directory that is
      already in your path (perhaps ~/localbin ?)

   6. After installing try the tutorial.

   7. To COMPLETELY remove the system go to the install directory and
   type: rm -r rnacad-1.1.1. There is also a make clean to do simple
   cleaning.

The makefile compiles programs in the ./src directory and then
configures some calling scripts. The configuration looks for the
location of perl and gawk in the installer's path. This make procedure
will leave a number of simple calling scripts ending in .exe in the
bin directory. Feel free to move these .exe files to where ever you
want them installed.

RNACAD has been installed on Intel Linux and Alpha Unix.

Because RNACAD is a collection of interwoven programs that call each
other, the .exe files explicitly refer to the install directory of
RNACAD so that the location of the RNACAD programs and data is
known. If you move the RNACAD install directory, the .exe script will
have nothing to call and nothing will work. Remake RNACAD to update
the .exe files to fix this.

I chose this solution rather than simply defining an environment
variable for the RNACAD directory because if the programs are run, for
example, from a web server as the user "nobody" then the environment
might be be correctly set. Here if you can excute the .exe file and
have the correct persmissions then the programs will run with no other
information.

After installing, the best place to start is the tutorial.