FortranLint for UNIX, command-line installation instructions  5-Sep-14
----------------------------------------------------------------------

These are the installation instructions for UNIX command-line versions
of FortranLint.

----------------------------------------------------------------------

0. If you are upgrading, it is STRONGLY recommended you back up your
   existing installation, either by tar tzvf or simply renaming your
   installation directory (e.g., mv flint flint.bak).

1. Download the appropriate tarball. Click on the link on this page
   to initiate download of the tarball.

   NOTE: The GUI version of the product also contains the command line
         version. This installation is recommended since it provdes the
         flexibility of using the GUI in addition to the command line.
         If this approach is more suitable, resume reading the install
         notes linked on this page for the GUI (flintgui_unix.txt).

   After downloading the appropriate tarball,  move it to the "/tmp"
   directory on the target system.

2. Log-in as "root" on the target system.  Note: "root" privileges are
   recommended, but are not required.

3. Create a directory to hold FortranLint. For example:

      mkdir -p /usr/local/cleanscape/flint     # For most systems
   or
      mkdir -p /opt/cleanscape/flint           # For Solaris

4. Go to the new directory. Unpack the tarball using a command similar
   to the following:

   For Linux systems:
      tar zxvf /tmp/flint_NAME.taz

   For other UNIX systems:
      gunzip  /tmp/flint_NAME.taz 
      tar xvf /tmp/flint_NAME.tar

5. Set environment variables.

   Edit your "login" scripts (and the "login" scripts for any other
   users who will be running FortranLint). Add  commands similar to the
   following:

      For "sh" users
      --------------------------------------------
      FLINTHOME=/usr/local/cleanscape/flint
      FLINTHOST=localhost
      export FLINTHOME
      export FLINTHOST
      PATH=$FLINTHOME:$PATH

      For "csh" users
      --------------------------------------------
      setenv FLINTHOME /usr/local/cleanscape/flint
      setenv FLINTHOST localhost
      set path = ( $FLINTHOME $path )
      rehash

   Note:  "FLINTHOME" should  specify the  program  directory  created
   in step 3. Modify the setting shown here as necessary.

   After making the changes, log out, then log-in again.

6. Install license keys.

   Execute the following command:
      flint activate

   This  should print a server code.  Copy the code, then press CTRL-C
   to abort "flint".

   Call Cleanscape at (800) 944-5468 and ask for a FortranLint 
   activation key.  Alternatively, mail the server code to 
   support@cleanscape.net along with your name, company name, and 
   telephone number.  Mention "FortranLint" in your message.

   Cleanscape will generate an activation key for you. 

   For evaluations, no key is required for Linux.  For all other hosts,
   an activation key is provided at no cost.

   When you receive the activation key,  run  "flint activate" again  
   and enter the key.  This should  create a  script  named  "startup" 
   in the "FLINTHOME" directory.

   Note: You may receive two activation keys. If so, run "flint activate"
   twice (once for each key).

7. Install license manager daemon - NOT REQUIRED FOR LINUX EVALUATION

   The "startup" script starts a license manager daemon.

   To install the daemon:
        (a) Make the "startup" script executable. For example:
            chmod a+x /usr/local/cleanscape/flint/startup

        (b) If you have  "root" access,  edit  the  appropriate system
            startup script,  add a line similar to the following,  and
            reboot the system:
            /usr/local/cleanscape/flint/startup &

        (c) If you don't have  "root" access,  execute the script man-
            ually.

8. Set up XLINT (optional).

   NOTE: The Cleanscape GUI provides more features than the Xlint 
         browser. Xlint is still provided for legacy users.

   FortranLint comes with a database browser named XLINT.  If you plan
   to use XLINT,  set two additional environment variables "XAPPLRESDIR" 
   and "XLINTHOME" as follows:

      "sh" example                 "csh" example
      ----------------------       -----------------------------
      XAPPLRESDIR=$FLINTHOME       setenv XAPPLRESDIR $FLINTHOME
      XLINTHOME=$FLINTHOME         setenv XLINTHOME   $FLINTHOME
      export XAPPLRESDIR
      export XLINTHOME

   You may also need to set the standard UNIX "DISPLAY" variable.

   For more information on XLINT,  see chapters 11 through 16 of the
   main FortranLint manual (located in the "Doc" subdirectory of the 
   main program directory).

   Note: Presently, XLINT assumes that the display is set to a 
         resolution of at least 1024x768.

9. Install "man" page (optional):

   To install the UNIX FortranLint "man" page, use commands similar
   to the following:

      cd $FLINTHOME
      mkdir -p      /usr/local/man/man1
      cp -p flint.1 /usr/local/man/man1

   Modify the directory path shown here as necessary.

The command-line version of  FortranLint  should now be  installed and
ready for use.  For more information, see the main FortranLint manual.
The  manual is  located in the "Doc" subdirectory of  the main program
directory (created in step 3).  Both text and PDF versions are provid-
ed.
