------------------------------------------
plusFORT 7.60 for Linux Installation Guide
------------------------------------------

Version 7.60 of plusFORT contains 64 bit executables, and must be installed on a 64 bit version of Linux running on an Intel or AMD x64 processor.

(1)  We recommend that you install plusFORT in /opt.  To do this you will need to logon as a superuser, or use sudo.

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

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

       tar xvzf plusfort_x64Linux_760.tgz

(4)  Step 3 will have created the plusFort installation directory (e.g. /opt/plusfort_x64Linux_760).  Copy your authorization file (plusFORT.fig), which contains 3 lines of text, into the installation directory.  Note that the filename is case-sensitive - it must be "plusFORT.fig" - NOT "plusfort.fig".

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

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

     Depending on your setup, these commands can be inserted in the .profile or .bashrc in your home directory, in /etc/bashrc or /etc/profile, or in a file in the /etc/profile.d directory (e.g. /etc/profile.d/plusfort.sh). You may need superuser privileges to do this.

(6)  Start a new command shell.

(7)  Check the environment variables are correctly set by typing:-

       echo $PFDIR

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

       e.g.  spag *.f

(9)  To make PFFE (the plusFORT graphical user interface) available via the	Applications menu, copy the "PFFE.desktop" file from the installation directory to /usr/share/applications.

       cp /opt/plusfort_x64Linux_760/PFFE.desktop /usr/share/applications

(10) There are HTML and CHM versions of the manual in the plusFORT installation directory (pfmanual.html and pfmanual.chm).

     The CHM version is preferred by most users, but on Linux, you will need to install a special viewer for CHM files.  We have found that kchmviewer works well, and is available for most Linux distributions.

     The manual is also available online at www.fortran.uk/plusfortmanual/index.html.
     
(11) Version 7.60 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.