GUI installation instructions      FortranLint for UNIX      22-Jun-07
----------------------------------------------------------------------

These  are  the  installation instructions  for  UNIX GUI  versions of
FortranLint.

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

1. Download the appropriate tarball as specified in your email from
   Cleanscape.

After downloading the appropriate tarball,  move it to the "/tmp" dir-
ectory 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 Cleanscape applications.  This directory
   is REQUIRED for the Flint GUI to operate correctly:

      mkdir -p /usr/local/cleanscape        # All systems as of v. 6.2

NOTE: You can optionally install this Cleanscape product anywhere, IF
      you use environment variable CSIAPPBASE and export it (bash) or
      setenv/rehash (csh).

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

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

For Linux systems:

      tar -zxvf /tmp/flintgui620_<platform>.taz

For other UNIX systems:

      compress -c -d < /tmp/flintgui_620<platform>.taz | tar xvf -

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

5. Set the PATH.

Edit your "login" scripts (and the "login" scripts for any other users
who will be running FortranLint).  Add the new  program directory from
step 3 to the current PATH.

For example:

      "sh" users
      --------------------------------------------
      PATH=/usr/local/cleanscape:$PATH

      "csh" users
      --------------------------------------------
      set path = ( /usr/local/cleanscape $path )
      rehash

Modify the path shown here appropriately.

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

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

You should now be able to run FortranLint.  To do so, execute the com-
mand "flintgui".

Note: The first time that you run "flintgui",  a "registration" prompt
will be displayed.  You must "register" the program before you can use
it. Registration is free, for evaluation purposes.

For more information on the registration procedure, see Appendix R be-
low.

For more information on the FortranLint GUI itself, see the GUI "quick-
start" guide. To access the guide, go to the directory created in step
3, then go to the following subdirectory:

      flintgui.dir/doc

The FortranLint GUI "quickstart" guide is provided in PDF format,  and
is named "flintgui.pdf".

The FortranLint GUI  package  includes  the  command-line  version  of
FortranLint. For more information on the command-line version, see the
command-line manual.  The manual is located in the  "doc" subdirectory
mentioned above.  The PDF version is named "flintman.pdf".


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

APPENDIX R - REGISTERING THE PRODUCTS.

When you run  a copy of the  UNIX FortranLint or  LintPlus GUI for the
first time,  it should  display a  dialog box  similar to  the follow-
ing:

      Select the kind of setup you want:
        * Current system only
        * Network license
      OK  Cancel

Select  the appropriate  setup and  click on OK.  "Current system"  is 
suitable for  single-user (node-locked)  licenses,  on the workstation 
designated as the  license server  for floating-license  installations,
and demo users.  

"Network license" is used ONLY for  client workstations in a floating-
license scheme.  

If you select  "Current system only",  the GUI should display a dialog
box similar to the following:

      Name:            ---
      Company:         ---
      Server Code:     ---
      Activation Code: ---
      OK  Cancel

The "Server Code" field will contain an numeric code. Email Cleanscape
at "support@cleanscape.net"),  and ask for an activation code.  You'll
need to provide  the information from the  "Server Code" field and the 
name of the product you're interested in (FortranLint or LintPlus).

Note: Activation codes are free for evaluation purposes.

Put the activation code which  Cleanscape gives you in the  Activation
Code field.  Fill out the  Name and Company fields,  and  click on OK.
After you do this, the GUI should be ready for use.

If you select "Network license",  the GUI should display  a dialog box
similar to the following:

      Name:           ---
      Company:        ---
      License server: ---
      OK  Cancel

Ask your  network administrator  for the name or the IP address of the
license server to use (for example, Sylvester or 192.168.20.34). Enter
the appropriate server name or IP address in the License server field.
Fill out the Name and Company fields, and click on OK.

Your network administrator will need to install a  UNIX "daemon" named
"iptlmd" on the server which is specified. Instructions for doing this
are provided in  the  FortranLint  command-line manual  (flintman.pdf,
Appendix A) and  in  the LintPlus  command-line manual  (lplusman.pdf,
Appendix A).

After the network administrator does this, the GUI should be ready for
use.

Note: The main  FortranLint manual (flintman.pdf)  is  located  in the
product subdirectory "flintgui.dir/doc", and the main LintPlus  manual
(lplusman.pdf) is located in the  product subdirectory  "lplusgui.dir/
doc".

If you'd like to change the  registration information used for a prod-
uct  (for example,  if you'd like to move the product from one machine
to another),  go to the  "Help" menu  and execute the  "Change license
key" command.
