LintPlus for UNIX, GUI installation instructions
----------------------------------------------------------------------

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

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

1. Download the appropriate tarball:

      * If you have a recent PC Linux distribution  (such as Red Hat 7
        or Slackware 8), get "lplusgui_linux.tar.gz".

      * If you have an old libc5-based PC Linux distribution  (such as
        Red Hat 4 or Slackware 3), get "lplusgui_oldlin.tar.gz".

      * If you have AIX     - get:  lplusgui_aix.tar.Z

      * If you have HPUX    - get:  lplusgui_hpux.tar.Z

      * If you have IRIX    - get:  lplusgui_irix.tar.Z

      * If you have Solaris - get:  lplusgui_solaris.tar.Z

      * If you have Tru64   - get:  lplusgui_tru64.tar.Z

Note: If you use FTP, remember to set "binary" mode.

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. For example:

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

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

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

For Linux systems:

      tar zxvf /tmp/lplusgui_NAME.tar.gz

For other UNIX systems:

      compress -c -d < /tmp/lplusgui_NAME.tar.Z | tar xvf -

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

5. Set the PATH.

Edit your "login" scripts (and the "login" scripts for any other users
who will be running LintPlus). 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.

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

6. Extra step for SGI IRIX.

If you're running under IRIX, an extra configuration step is needed.

To configure LintPlus for IRIX, go to the directory created in step 3,
then go to the following subdirectory:

      lplusgui.dir/main/sgi

Follow the instructions in the text file "README.SGI".

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

You should now be able to run LintPlus.  To do so, execute the command
"lplusgui".

Note: The first time that you run "lplusgui",  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  LintPlus 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:

      lplusgui.dir/doc

The LintPlus GUI "quickstart" guide is provided in  PDF format, and is
named "lplusgui.pdf".

The LintPlus GUI package  includes the  command-line version of  Lint-
Plus.  For more information on the command-line version,  see the com-
mand-line manual. The manual is located in the "doc" subdirectory men-
tioned above.  Both text and PDF versions are provided; the text vers-
ion is named "lplusman.txt",  and the  PDF version is named "lplusman.
pdf".

The LintPlus GUI package  also includes a copy of  FortranLint (Clean-
scape's  Fortran source code analyzer).  If you'd to try  FortranLint,
execute  the following command and  repeat the  registration procedure
described in Appendix R below:

      flintgui

Note: You'll need  to ask  Cleanscape for  a second "activation" code;
the "activation" codes for the two products are not interchangeable.

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

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.  Most users will want to
use "Current system only", which is the default setting.  If your net-
work has a license server, and you'd like to use a "floating" (or net-
work-based) license, select "Network license" instead.

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 alphanumeric code. Call Clean-
scape at (800) 944-5468  (or send E-mail to "activate@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 inter-
ested 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.
