              Fortran Company / NAG F Compiler, Version 95

                         Installers' Notes

                             Contents


1. Introduction

2. Implementation Provided

3. Distribution Medium

   3.1. Recording Details
   3.2. Contents
   3.3. File Sizes

4. Installation

   4.1. Installation
   4.2. Checking Accessibility
 
5. Services from the Fortran Company

---------------------------------------------------------------------
 
1. Introduction
 
   This document is essential reading for the Site Contact
   responsible for installation and maintenance of the F
   Compiler implementation specified in the title. The installer will
   be provided with an electronic copy of this document which is also
   supplied on the distribution medium.

   You are responsible for reading and abiding by the Software Agreement
   fount in the file "license" in the doc directory.

   This version of F for Windows runs only from the command line
   in a DOS window.
 
2. Implementation Provided
 
   This implementation is a compiled, tested, ready-to-use version
   of the Fortran Company / NAG F Compiler that is considered suitable for
   operation on the computer systems detailed below:
 
   Linux:
         hardware:           Intel 486 or later
         operating system:   Linux (built on Red Hat 7.1)
         additional systems: The GNU C compiler (gcc)
                             and run-time libraries MUST be installed.

   Solaris
         hardware:           SPARC
         operating system:   Solaris 2 and later (built on 2.5)
         additional systems: The GNU C compiler (gcc)
                             and run-time libraries MUST be installed.

   Windows
         hardware            Intel 486 and later
         operating system:   All versions of Windows, DOS (built on WME)
         additional systems  The GNU C compiler (gcc)
                             and run-time libraries MUST be installed.

      This windows version was compiled using Mingw, available
      either with the F compiler f_and_ming_????????.zip or from
      the web site:

            http://www.mingw.org

      The previous version was compiled using the Cygwin tools
      available from the following site:

            http://sources.redhat.com/cygwin

      but for some reason I have not been able to get that to work
      yet with the current version.

      Things probably will work on Windows if the gcc compiler is
      installed anywhere on your execution path, but we recommend
      installing the Mingw tools (they are free).

3. Distribution Medium

3.1. Recording Details

     The implementation is distributed in tar/zip compressed format.

3.2. Contents

     LINUX/UNIX:

     The following shows the directory/file organization of the
     materials on the distribution media. A brief description of
     some of the files is given.

       +------ bin
       |
       |------ doc
       |
     --+------ lib
       |
       |------ examples
       |
       +------ src

     bin:

     Contains the main executable F and fpp, the F preprocessor.

     doc:

     Contains the on-line help man pages and plain text copies of the
     Installers' Note (this document) and the software license:

             README       F.in
             F.1    slatec.1    f90_unix_proc.3
             (possibly other .3 man pages)
             F.pdf (the man page in PDF format)
             F.ps (the man page in PostScript format)

     lib:

     Contains the files:

             fcomp
             dope.h          f95.h         hpf.h
             libf96.a        libslatec.a   libg2c.a
             (possibly other library files depending on platform)
             several .mod files containing module information

    examples:

    Contains several examples, including calling a C function,
    calling a Fortran 77 program compiled with g77,
    calling "system", and getting command line arguments.

    src:

    Contains source code for some of the programs provides under
    the GNU license or developed by the Fortran Company.

    WINDOWS:

    The single F folder contains the same folders as listed above for
    Linux and Unix: bin, doc, lib, examples, and src.  It also contains
    the folder tmp, which is the default location to hold temporary
    files during compilation.  If you get the distribution that includes
    Mingw, there is an additional Mingw folder for it.

3.3. File Sizes

     The F files require approximately 4MB of disc space.

     Mingw requires approximately 34MB.

4. Installation

     LINUX/UNIX:

     Note: You may need to be root to install the software.
     If you are not, see below about the library file and
     location of gcc.

     First uncompress the file, e.g.,

            gzip -d f_linux.tar.gz

     Then untar the resulting tar file, e.g.,

            tar xvf f_linux.tar

     If the installation is being done as root (Unix/Linux),
     the ownership of the files should be altered, e.g.

            chown -R root.bin *

     The file F in the bin subdirectory should be copied to a suitable
     location from where it can be accessed by users, e.g.

            cp bin/* /usr/local/bin

     This directory must have read and execute permission and must be
     in your execution path.

     The files in the lib subdirectory should be copied to a directory
     such as /usr/local/lib/F or /opt/F/lib, e.g.

            mkdir /usr/local/lib/F
            cp -d -p lib/* /usr/local/lib/F

     For some platforms (Unix) there are linked files and the
     -d (no dereference) option preserves the links.  The -p
     option preserves permissions.

     For the linux distribution, the default library is /usr/local/lib/F.
     For the solaris distribution, the default library is /opt/F/lib.

     If you must use another directory to store the library files (for
     example, you may not have access to the /usr directory), you
     must compile with the -Qpath option:

            F -Qpath /my_library_path/F my_prog.f95

     Similarly, the F compiler assumes the gcc compiler is in
     /usr/local/bin; if it is not, someone with root privileges
     needs to create a link to that location. 

     The man pages in the doc directory should be copied to the
     appropriate man directory, e.g.

            cp doc/*.1 /usr/man/man1
            cp doc/*.3 /usr/man/man3

     On some systems, it should be /opt, rather than /usr.  You
     should be able to find the man pages wherever they are by
     modifying the environment variable MANPATH.

     WINDOWS:

     Select a location to install F.

        cd C:\my_stuff

     Unzip the source file.  This will produce the folder F
     and produce the subfolders bin, doc, lib, examples, and
     tmp.  If you have the distribution that includes Mingw,
     it will create a second folder Mingw.

     Make sure that the folder containing the executable F.exe
     (...F\bin) and the gcc compiler are in your path.
     A way to do this is to edit your AUTOEXEC.BAT file to add
     the line

         PATH=C:\my_stuff\F\bin;C:\my_stuff\Mingw\bin;%PATH%

     assuming C:\my_stuff\Mingw\bin contains the gcc executable.

     If it appears there are difficulties finding or creating
     files, try using the -Qpath and -tempdir compiler options
     as described above and in the F man page (F.1, F.ps, F.pdf).

     On NT, click Start -> Settings -> Control Panel in the SYSTEM
     application.  In SYSTEM, go to the ENVIRONMENT tab.  Scroll
     down in the "System Variables" in the top window (note that
     the bottom window is per-user variables) until you get to
     PATH.  Click on PATH and update the value in the line at the
     bottom of the screen by adding the appropriate paths, followed
     by a semicolon to separate them from the paths already there.

     To ensure that this is in effect (you may need to log in again
     or reboot); type

         echo %PATH%

     If you are using the Cygwin tools, the man pages in the doc
     directory should be copied to the appropriate man directory,
     e.g.

         cp doc/*.1 /usr/man/man1

4.2. Checking Accessibility

     Installation may be checked by compiling and running the test
     program examples/seven_11.f95.  To compile and link the program,
     copy the source file to your working directory and type:

            F seven_11.f95  or simply  F seven_11

5. Services from The Fortran Company.

   (a) Support

       It may be possible for your local advisory service or your
       Site Contact to resolve queries concerning this document or the
       implementation in general. However, please do contact The Fortran Co.
       at the supplied address, if you have any difficulties.

       Technical queries should be addressed to:

       info@fortran.com

   (b) Other sources of information

       Copies of the book "Programmers Guide to F", by Brainerd,
       Goldberg, and Adams, "Key Features of F", by Adams, Brainerd,
       Martin, and Smith, and other books about F are available:

       http://www.fortran.com/books.html

       or

       The Fortran Company
       11155 E. Mountain Gate Place
       Tucson, Arizona 85749 USA
       +1-520-256-1455  +1-520-760-1397 (fax)
       info@fortran.com
