1. Setting up your folders

a. Decide on the root directory where your software is going to go.... [/home/friday], for example.

b. In your .cshrc file, define
setenv OSROOT /home/friday
The makefiles need OSROOT in order to find everything....

c. At some stage you will need the following folders (you may already have them)

[/home/friday/]lib	Holder for object libraries
[/home/friday/]bin	Holder for runtime binaries and scripts
[/home/friday/]include	Holder for shared source code (f77 include files)
[/home/friday/]mod	Holder for shared source code (f90 modules)
[/home/friday/]spectrum	Root folder for SPECTRUM
[/home/friday/]sterne	Root folder for STERNE
[/home/friday/]tfit	Root folder for SFIT, TFIT, ...

Some of these should be created automatically when you download and unpack the tar files.

2. Obtaining the software

Collect the appropriate tar files from Simon's Software Store
You will need 'tools' and 'include' at the very least. These are gzipped. Then:

• gunzip tools.tar.
• cd [/home/friday]
• tar xvf [wherever_the_tarfile_is]/tools.tar , etc....

Note. Some tar files may contain more or less files than are actually required. Please let CSJ know about problems.

3. Building subroutine libraries

Each subroutine library is contained in a subfolder, e.g. ./qub. It will consist of

• source code contained in a text library ./qub/qub.a
• a makefile containing a list of the subprograms to be included in the object library
• (after make) an object code library ./qub/libqub.a
• (after make install) a soft link in the library folder ../lib/libqub.a

Each library makefile only defines things unique to that library. Then a common section of code, found in ../make_library (or ../make_library90) supplies all the necessary targets:

• build - extract fortran from the source library, compile source, pack object code into object libary
• install - create symlink in ./lib to object library
• clean - remove source and object files from library folder
• update - replace any changed source files in the source library
• remove - remove everything except basic files

The conservative way to build this library is:
cd /home/friday/qub; make; make install; make clean

System-specific variables (eg compilers - FC, compiler options - FFLAGS) should be set in .cshrc or .login.

If you are feeling really brave, you can attempt the global build:
cd /home/friday/; make