INSTALL for rf-4.45.0 		M.J.Harrison 05/13/2024


1. Bootstrap

If you do not have a copy of a Ratfor preprocessor you will, of course, be
unable to build from Ratfor source. The directory rf-4.45.0/bootstrap contains
FORTRAN source that can be compiled with any FORTRAN 77 or more recent compiler,
and it is assumed that you must have such a compiler available because otherwise
there would be no point in building rf. The supplied compilers.mk uses gfortran
by default.

To build the bootstrap, cd to rf-4.45.0 and edit compilers.mk. Then cd to the
bootstrap directory and enter the command "make". This will build an executable
called "rf" in this directory.  Then either copy rf to a directory on your PATH,
or set up a link, called "rf", to it from any directory on your PATH. If you
wish, you can just use this version as it stands, but a good way to verify that
it built correctly is to use it to rebuild the Ratfor source.

IMPORTANT NOTE:

  If you are upgrading to release 4.45.0 from any prior release you will have to
  use the bootstrap, because the new source uses the new elsedef statement and
  this is not recognized by the parser in prior releases.

2. Building the Ratfor source

Change your current directory to rf-4.45.0. First (if you did not build the
bootstrap) edit compilers.mk. Then enter the command "make". This will build the
preprocessor in this directory and rf run-time library in the lib subdirectory.


3. Installing

To install in the "standard" place, change your current directory to rf-4.45.0
and enter "sudo make install"; this will copy rf to /usr/local/bin, librf.a to
/usr/local/lib, and rf.1 to /usr/man/man1. To install in a more private place
(e.g. for initial testing), enter "make myinstall", which will copy rf to
$HOME/bin and lib/librf.a to $HOME/lib (creating these directories if
necessary).


4. Cleaning Up

To remove all the files generated by the build, change your current
directory to rf-4.45.0 and enter "make clean".