Cleanscape GUI installation instructions on Unix/Linux       19-Feb-08
----------------------------------------------------------------------

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"
   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 Cleanscape applications, for example,

      mkdir -p /usr/local/cleanscape

IRIX NOTE:  You MUST specify the installation directory in environment
            variable  CSIAPPBASE.  Using the above directory as an ex-
            ample (and using a bash shell):

            export CSIAPPBASE=/usr/local/cleanscape


4. Go to the new directory. Unpack the tarball using these commands:

      gunzip  /tmp/<prod>gui<ver>-<OS>.taz
      tar xvf /tmp/<prod>gui<ver>-<OS>.tar


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.


6. Start the GUI.

   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, and you must be logged in as root to install the key
         and start the license daemon.

         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:

         <prod>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).


7. Command line version.

   The GUI package  contains a command line version as well, suitable
   for inclusion in builds or batch modes of operation.  To run it, set
   the following environment variables and add it/them to PATH.  The
   following examples assume bash and the /usr/local/cleanscape as the
   installation directory:

   flint:   export FLINTHOME=/usr/local/cleanscape/flintgui.dir/main
   lplus:   export   CSIHOME=/usr/local/cleanscape/lplusgui.dir/main
   cpplint: export   IPTLINT=/usr/local/cleanscape/cpplintgui.dir/main

   export PATH=$<prod_env_var_from_above>:$PATH

   For 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 use.

   "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. Copy this val-
   ue into an email to support@cleanscape.net and ask for an activation
   code.  Be sure to include 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 IP address of the
   license server to use (e.g.,, Sylvester or 192.168.20.34). Enter the
   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 run the command 'startup' lo-
   cated in the 'main' subdirectory on the specified server.  This will
   start the 'iptlmd' license daemon.  Instructions for doing this are
   provided in the following manuals located in the 'doc' subdirectory:

   Flint:   flintgui.pdf, section 2.2, AND flintman.pdf, Appendix A
   Lplus:   lplusgui.pdf, section 2.2, AND lplusman.pdf, Appendix A
   C++lint: cpplint_guide.pdf, section 2.2

   Upon completion, 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.
