Stallmann, Brglez, Ghosh: Software Installation

The software in this package is known to run on Solaris 2.5 and 2.6 and on Linux 2.4. A recent version of the gnu gcc/g++ compiler (2.8.1 or later) is assumed.

Installation requires about 5MB of disk space, or 3MB for the bin directory and 2MB for the rest. To run the example, you need at least another 8MB in the data directory.

The sbg_install script does the actual installation -- usage is

   sbg_install [ root_directory [ bin_directory ] ]

• root_directory is where directories bin, data, various scripts, and src will be installed as subdirectories (default, when there are no arguments, is the current directory)
• bin_directory is where the binary executables will be stored (default is the bin directory under root_directory)

After installation and before execution, you need to do one of the following:

1. Give the command

            setenv PROGRAM_DIRECTORY bin_directory
   		 

   or its Bourne shell equivalent

            export PROGRAM_DIRECTORY=bin_directory
          

   before running any of the scripts; the script then automatically incorporates bin_directory into the current path.
2. Put the command

            setenv PATH "bin_directory:$PATH"
   		 

   into your .cshrc file (or whatever the init file for your shell is).
3. If the directory you specified as your bin_directory is already part of your default path, there is no need to do either of the above (before making such a decision, be sure that there are no name conflicts with existing programs -- our executables all have names beginning with sbg_ so this should not be a problem).