Hamilton C shell(tm) Installation 2.2.72 for Windows NT on MIPS R4x00.
Copyright (c) 1988-1996 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        Internet:  hamilton@bix.com
         Telex:   6503890321


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 MIPS R4000- or R4400-based machine running
   Windows NT 3.1 or later.  Roughly 5.0 MB of disk space is used.


Basic Installation:


   1. Copy the bin and samples directories and other files on these
      diskettes to 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 four parts.)  Most customers create a
      directory in the root of one of their drives called "hamilton"
      to hold everything.


   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.  Most users treat the home
      directory as a place for all their personal files and subdirectories
      and give it their own first name, e.g., C:\DOUG.


   3. Edit the login.csh and startup.csh files, customizing them to meet
      your needs.  If you're new to the C shell, you'll probably want to
      get started by just accepting them the way they came, but experienced
      users may want to add their own aliases, etc.


   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.  You have a choice of whether to change
      the system variables (seen by all users on yoiur machine) or just
      your own user variables.

      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.
         You'll probably also want to add an entry in the beginning for ".",
         the current directory.

      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:

         PATH=.;d:\hamilton\bin;d:\hamilton\samples
         HOME=d:\doug
         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. Most people find it useful to run the C shell in a window with more
      than just 25 lines and an even larger buffer with a scroll bar on
      the right.  You can resize the buffer and window using the setrows
      command.  For example,

         setrows 300 35

      will give you a 300-line buffer with a 35-line window.  Once you find
      a setting you like, you can save this for future sessions by pulling
      down the system button (the button in the upper left corner of the
      window), selecting "Properties...", pressing OK, then responding OK
      again when asked if you'd like these properties applied to future
      windows with the same title.


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.
