------------------------------------------
plusFORT 7.51 for MacOS Installation Guide
------------------------------------------

Version 7.51 of plusFORT cotains 64 bit executables, and must be installed on MacOS version 10.11 (El Capitan) or later.

(1)  Move the installation file, plusfort_MacOS_751.tgz, to the directory (e.g. /opt) which will contain the plusFORT installation directory.

(2)  Move to the directory containing the installation file, and unpack it:-

       tar xvzf plusfort_MacOS_751.tgz

You may need superuser privileges (e.g. using sudo) to do this.

(4)  Step 3 will have created the plusFORT installation directory (e.g. /opt/plusfort_MacOS_751).  Copy your authorization file (plusFORT.fig), which contains 3 lines of text, into the installation directory.

(5)  Set up the PFDIR and PATH environment variables.  For bash style shells, you can do this as follows:-

       PFDIR=/opt/plusfort_MacOS_751
       PATH=$PFDIR:$PATH
       export PFDIR PATH

These commands can be inserted in the .profile in your home directory, or in /etc/profile.  On some systems you may need to insert them in the .bash_profile file.

(6)   Start a new command shell, and check the environment variables are correctly set by typing:-

       echo $PFDIR

(7)  You should now be able to use plusFORT tools from the command line:-

       e.g.  spag *.f

(8)  Create an application bundle for PFFE, the plusFORT graphical interface, by typing:-

       make_PFFE_app

     You can now statrt PFFE by typing

       open PFFE.app

     To make PFFE available as a standard Mac application, move the PFFE.app folder created above into your system's Applications folder

       mv PFFE.app /Applications

(9)  If you installed plusFORT in /opt, an HTML version of the plusFORT manual may be found at

       /opt/plusfort_MacOS_751/manual/pfmanual.html

     or online at www.fortran.uk/plusfortmanual/index.html.

     The manual is also available in compiled hypertext (.chm) format at

       /opt/plusfort_MacOS_751/manual/pfmanual.chm

     There are a number of free and paid-for applications available via the App store for reading .chm files on Mac computers.

(10) Version 7.51 includes HyperKWIC, a new tool which generates hyperlinked keyword in context documentation for code written in any language.  There are HTML and CHM versions of the HyperKWIC manual in the HyperKWIC_manual subdirectory of the installation directory.