Hamilton C shell(tm) Installation 2.2.30 for Windows NT on DEC Alpha AXP
Copyright (c) 1988-1994 by Hamilton Laboratories.  All rights reserved.


This file describes how to install Hamilton C shell on Windows NT(tm).

If you have problems, please contact us for help.  We can be reached as
follows:

         phone:   508-440-8307         FAX:  508-440-8308
   BIX Network:   hamilton        MCI Mail:  389-0321
         Telex:   6503890321      Internet:  hamilton@bix.com or
                                             3890321@mcimail.com

When you've finished the installation, please mail in or FAX the registration
form.  This lets us know who you are so we can send updates and your feedback
helps us to better meet your needs in the future.

Please refer to the file readme.too for additional release notes.


System Requirements:


   Installation requires a DEC Alpha AXP-based machine running Windows NT
   build 528 (Final Release) or later.  Roughly 4.24 MB of disk space is used.


Basic Installation:


   1. Copy the contents of the bin and samples directories onto your hard
      disk, putting them anywhere you like.  (Notice that the bin directory
      is too big to fit on one diskette; you have to merge the three parts.)


   2. Copy the login.csh and startup.csh files into any directory you care
      to designate as your "home" directory.  The significance of a home
      directory is principally that it will be convenient to specify
      pathnames relative to this directory.


   3. Edit the login.csh and startup.csh files, customizing them to meet
      your needs.  The login.csh file has a lot of comments in it which
      can take the shell a second or more to read each time it starts up;
      you'll almost certainly want to delete some of these comments once
      you've read them so the shell will start up faster.


   4. Edit the environment variables by opening the Control Panel and then,
      within that, opening the system icon.

      To define a variable through the Control Panel, type the variable name
      in the "Variable:" fill-in box, the value in the "Value:" box and
      click on the "Set" button.

      a. Create or edit your entry for the Path variable, adding the full
         pathnames for the C shell's bin and samples directories to the list.

      b. Create an entry for the HOME environment variable, setting its value
         as the full pathname of the directory where you placed login.csh and
         startup.csh.

      c. You may also want to include definitions for TABS and COLORS.  The
         shell and all the utilities look for TABS to see if you want them
         to display text with tabs expanded out to something other than the
         default of every 8 characters.

         By default, the C shell displays white characters on a black
         background.  The COLORS variable lets you choose a combination from
         this set: black, red, green, yellow, blue, magenta (or blue red),
         cyan (or blue green) and white.  Foreground collows may also be
         bright, dim, blink or reverse.  The keyword "on" introduces
         background colors.  (Blink only causes true blinking full-screen;
         in a text window, it just makes the background brighter.  Also,
         yellow is a true yellow only if it's bright.  These are system
         limitations not related to the C shell.)

         Other color settings you might want to specify now or at some later
         time through the Control Panel are MOREPROMPT, MOREFILLIN and
         MOREERROR (for customizing the more utility's command line) and
         DELETIONS and ADDITIONS (for customizing the diff utility).

         For more information on setting screen colors, please refer to the
         the colors.csh file in the samples directory or to the Customization
         chapter in the User Manual.

      Here's an example of the settings you might specify:

         HOME=d:\doug
         PATH=d:\hamilton\bin;d:\hamilton\samples
         COLORS=white on blue
         TABS=3
         ADDITIONS=bright white on green
         DELETIONS=bright white on red
         MOREPROMPT=red on white
         MOREFILLIN=black
         MOREERROR=bright white on red


   5. Add csh.exe with the title "Hamilton C shell" to the Program Manager.
      To do this, pull-down "File" and select "New".   A pop-up will appear
      asking that you confirm this will be a new Program Item.  On the next
      pop-up, fill in:

         Description:      Hamilton C shell
         Command Line:     ....as appropriate....\csh.exe -L

      The "-L" part tells csh.exe when it starts up that it's a "login"
      shell, which means it should look for a login.csh file.  (Refer to
      the User Guide for additional information on other options.)


   6. Logout of your Windows session and then log back in to cause all the new
      settings to take effect.


The files on this diskette are licensed material, property of Hamilton
Laboratories, Sudbury, Massachusetts.

Windows NT is a trademark of Microsoft Corporaton.  Hamilton C shell is
a trademark of Hamilton Laboratories.
