Hamilton C shell(tm) Installation 2.2.114 for Windows 95 and Windows NT
on Intel x86.
Copyright (c) 1988-1996 by Hamilton Laboratories.  All rights reserved.


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

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

         phone:   978-440-8307
         FAX:     978-440-8308
         Email:   hamilton@hamiltonlabs.com
         Web:     http://www.hamiltonlabs.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 386-, 486- or Pentium-based machine running
   Windows 95 or Windows NT 3.1 or later.  Roughly 3.4 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 several 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.
   
      Windows NT:
      
         Do this 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 your machine) or just your own user variables.

      Windows 95:
      
         Do this by editing the c:\autoexec.bat file.  To define a variable,
         add a line of the form:

            set variable=value

         where "variable" is the name of the variable and "value" is the
         character string you want it set to.  Notice there are no spaces
         around the = sign.

      On either system:

      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.

         Under Windows 95, you'll want to add the ".", bin and samples
         directories to the search path already predefined by the system.
         The predefined value can be referred to as %Path%.  For example,
         you might type:

            set Path=.;c:\hamilton\bin;c:\hamilton\samples;%Path%

      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.

      Under Windows NT, 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

      Under Windows 95, you might specify:

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


   5. Set up an icon you can click on to start the C shell:
   
      Windows NT:

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

      Windows 95:
      
         Create a shortcut on the desktop to the C shell.  Open up
         "My Computer", then the appropriate disk, etc., until you've
         gotten to the directory containing csh.exe.  Drag that to the
         desktop using the right mouse button, replying "yes" to the
         popup asking if you want to create a shortcut.  You can edit
         the title under the icon by slowly clicking twice on the title.
         Press Enter when you've finished.

         Left click on the icon and select Properties to bring up the
         Properties window.  Go to the "Shortcut" page and edit the "Target"
         entry to add the "-L" option.  Type the name of your home
         directory in the "Start in:" field.

         Since Windows 95 doesn't properly recognize icons inside
         console applications in the current release (this appears to
         be a bug in Win95), you'll have to manually use the the
         "Change Icon..." button to bring up the popup where you can
         browse for csh.ico in the bin directory where you put csh.exe.
         Press Apply, then OK when you're done.


   6. Under Windows 95, you'll need to shutdown and restart the machine
      to have any changes you make to autoexec.bat take effect.  Under
      Windows NT, the changes you make via the Control Panel take
      effect immediately.


   7. Additional customization:

      Windows NT:

         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.

      Windows 95:
         
         Windows 95 doesn't support arbitrary-size console windows or
         buffers reliably.  The close button (the "X" in the upper
         right corner) doesn't work right with console applications.
         Even if you fix the icon that's displayed with your shortcut
         (as described above), the C shell will still show just the
         default MS-DOS icon in its title bar when it runs.  The
         properties popup (right button) will let you change some of
         this, but the values can't be saved that way for future
         invocations of the C shell.
         
         The reason for these problems is that because Win95 is really
         a 16-bit system, it's using an intermediate program, conagent.exe,
         to actually run 32-bit console applications like the C shell.
         If you want to make changes in window size, or how the close
         button works or what icon is used, you must make the changes
         to conagent, not the C shell.  To do this, use the Win95
         Explorer to open up the \windows\system directory.  Right-click
         on conagent and select Properties.  You can change the icon to
         csh.ico on the Program page, set whatever screen size you like
         on the Screen page, and enable the close button by clearing the
         check box next to "Warn if still active" on the Misc page.

         Do bear in mind, however, that any changes you make to conagent
         will affect all Win32 console apps you run.  (But note:  the
         MS-DOS command.com program is NOT a 32-bit application, so it
         will NOT be affected.)


The files on these diskettes are licensed material, property of Hamilton
Laboratories, Sudbury, Massachusetts.

Windows is a registered trademark and Windows NT is a trademark of
Microsoft Corporation.  Hamilton C shell is a trademark of Hamilton
Laboratories.
