Cleanscape GUI installation instructions on Unix/Linux       13-Sep-07
----------------------------------------------------------------------

These are the installation instructions for UNIX/Linux GUI versions of
Cleanscape Fortran-lint (Flint), Lint-Plus (Lplus), and C++lint.

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

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 GUI to operate correctly:

      mkdir -p /usr/local/cleanscape        # All systems as of v. 1.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/<product>gui<version>_<OS>.taz

For other UNIX systems:

      compress -c -d < /tmp/<product>gui<version>_<OS>.taz tar xvf -

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

5. Set the PATH.

Edit your "login" scripts (and the "login" scripts for any other users
who will be running C++lint.  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 the GUI.  To do so, execute one of the
following commands:
For Flint   - flintgui
For Lplus   - lplusgui
For C++lint - cpplintgui

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

*** For details on the registration procedure, see Appendix R below ***

For more information on the 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:

      <product>gui.dir/doc

The GUI "quickstart" guide is provided in PDF format, and is named
is named "flintgui.pdf" (Flint), "lplusgui.pdf" (Lplus), or 
"cpplint_guide.pdf" (C++lint).

The GUI package  contains a command line version as well.  For more
more information on the command-line version, see the accompanying
reference manaul located in the  "doc" subdirectory mentioned above.
The PDF versions are named "flintman.pdf" (Flint), "lplusman.pdf"
(Lplus), or "pc-lint.pdf" (C++lint).


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

APPENDIX R - REGISTERING THE PRODUCTS.

When you run a copy of the Cleanscape GUI for the first time, it should
display a dialog box similar to the following:

      Select the kind of setup you want:
        * Single-User or Network Server
        * Network Client
      OK  Cancel

Select  the appropriate  setup and  click on OK.  "Single-User"  is
suitable for node-locked licenses, on the workstation designated as the 
license server for floating-license installations, and demo users.

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

If you select  "Single-User",  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 (Flint, Lplus, or C++lint).

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 Client",  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  Flint  command-line manual  (flintman.pdf, Appen-
dix A), the Lplus command-line manual (lplusman.pdf, Appendix A), and
the C++lint users guide (cpplint_guide.pdf, section 2.2).

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

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.
