home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / hcshdemo.zip / csh-os2.zip / README < prev    next >
Text File  |  1994-05-20  |  17KB  |  418 lines
  1. Hamilton C shell(tm) Installation 2.2.m
  2. Copyright (c) 1988-1993 by Hamilton Laboratories.  All rights reserved.
  3.  
  4.  
  5. This file describes how to install Hamilton C shell on your system.  We
  6. suggest a basic installation initially but once you've gained some
  7. familiarity with the C shell, you may want to set it up as the default
  8. command processor for OS/2, completely replacing cmd.exe.  (The advantage
  9. to be gained by installing it as the default command processor is that
  10. the C shell will then be able to change its title bar and icon.)
  11.  
  12. If you have problems, please contact us for help.  We can be reached as
  13. follows:
  14.  
  15.          phone:   508-358-5715         FAX:  508-358-1113
  16.    BIX Network:   hamilton        MCI Mail:  389-0321
  17.          Telex:   6503890321      Internet:  3890321@mcimail.com or
  18.     CompuServe:   70034,2025                 hamilton@bix.com
  19.  
  20. When you've finished the installation, please mail in or FAX the registration
  21. form.  This lets us know who you are so we can send updates and your feedback
  22. helps us to better meet your needs in the future.
  23.  
  24. Please refer to the file readme.too for additional release notes.
  25.  
  26.  
  27. System Requirements:
  28.  
  29.    Installation requires a 286-, 386- or 486-based AT+ or PS/2+
  30.    or compatible, running OS/2 1.1 (Presentation Manager) or
  31.    Microsoft SDK 1.06 or later.  Roughly 1.3 MB of disk space is
  32.    used.
  33.    
  34.    Hamilton C shell and the utilities supplied with it fully
  35.    support HPFS and long filenames when running under OS/2 1.2
  36.    or later. They will work properly in a Presentation Manager
  37.    text window or full-screen and with networks such as LAN
  38.    Manager or IBM LAN Server.  If you're using OS/2 2.0 or 2.1,
  39.    it knows how to run 32-bit applications and start up Multiple
  40.    Virtual Dos machines.  The product is not copy protected.
  41.  
  42.  
  43. Installation on OS/2:
  44.  
  45.    The first few steps, copying files from diskette to your
  46.    hard disk and modifying your config.sys, are the same on all
  47.    releases of OS/2.  The remaining steps -- those associated
  48.    with actually installing Hamilton C shell on your OS/2
  49.    desktop -- depend on which release of OS/2 you're running.
  50.    We suggest a "vanilla" installation initially, but later
  51.    you may want to customize it to your own tastes.  For help
  52.    with that, read the chapter on "Customizing the Shell"
  53.    in the manual.
  54.  
  55.    Once you've gained familiarity with both OS/2 and with the C
  56.    shell, you may want to set up the C shell as the  default
  57.    command processor for OS/2, completely replacing cmd.exe.
  58.    The advantage to be gained (except under the 6.167 Beta and
  59.    LA builds of 2.0) is that the C shell will then be able to
  60.    change its own title bar and icon when you run an external
  61.    command.
  62.  
  63.  
  64. Basic Installation, Part I  (All releases of OS/2):
  65.  
  66.    1. Copy the executables in the bin directory into any
  67.       desired directory on your search PATH, so long as it
  68.       appears ahead of the directory containing the standard
  69.       IBM/Microsoft more.com.  (We supply a dramatically
  70.       improved more.exe, which should take precedence.)  If
  71.       you're creating a new directory, remember to add it to
  72.       your search PATH in config.sys and in the login.csh
  73.       file you create next.
  74.  
  75.    2. Edit config.sys, adding statements to define whatever
  76.       directory you choose to designate as your HOME
  77.       directory and to ensure you're configured for a
  78.       sufficient number of threads.    The significance of a
  79.       home directory is principally that it will be
  80.       convenient to specify pathnames relative to that
  81.       directory.  The default number of threads is too small
  82.       if you expect to have lots of windows open.  Also, be
  83.       sure your PATH explicitly lists ".", the current
  84.       directory.
  85.  
  86.       You may also want to include definitions for TABS and
  87.       COLORS.  more.exe and some of the other utilities look
  88.       for TABS to see if you want them to display text with
  89.       tabs expanded out to something other than the default
  90.       of every 8 characters.
  91.  
  92.       By default, the C shell displays white characters on a
  93.       black background.  The COLORS variable lets you choose
  94.       something different from this set:  black, red, green,
  95.       yellow, blue, magenta (or blue red), cyan (or blue
  96.       green) and white.  Foreground colors may also be
  97.       bright, dim, blink or reverse.  The keyword "on"
  98.       introduces background colors.  (Blink only causes true
  99.       blinking full-screen; in a text window, it just makes
  100.       the background brighter.  Also, yellow is a true yellow
  101.       only if it's bright.  These are OS/2 limitations not
  102.       related to the C shell.)  For more information on
  103.       setting screen colors, please refer to the
  104.       customization chapter or to the colors.csh file in the
  105.       samples directory.
  106.  
  107.       Here's an example of what you might add to config.sys:
  108.  
  109.             THREADS=255
  110.             SET HOME=D:\DOUG
  111.             SET TABS=3
  112.             SET COLORS=WHITE ON BLUE
  113.  
  114.       (Please be sure your config.sys file contains only
  115.       upper-case alphabetics, no lower-case, if you're using
  116.       OS/2 1.  1. Lower-case alphabetics were known to cause
  117.       random OS/2 system failures in that release of OS/2.
  118.       This was a known bug in the OS/2 kernel and was not
  119.       application dependent.)
  120.  
  121.    3. Copy the login.csh and startup.csh files into "home"
  122.       directory.
  123.  
  124.       Unless you're convinced that you've set all your
  125.       environmental variables in your config.sys (and that
  126.       your PATH explicitly lists ".", the current
  127.       directory), use the dumpenv utility to paste a series
  128.       of setenv statements into the login.csh file to
  129.       recreate the environment you've been using with
  130.       cmd.exe:
  131.  
  132.       dumpenv >>login.csh
  133.  
  134.       (To see what dumpenv does, look at the source code in
  135.       the samples directory or simply run dumpenv without
  136.       redirecting the output.)
  137.  
  138.       The login.csh and startup.csh files can be edited with
  139.       any ascii editor to customize the shell to your needs.
  140.       The login.csh file has a lot of comments in it which
  141.       can take the shell a second or more to read; you'll
  142.       almost certainly want to delete some of them once
  143.       you've read them so the shell will start up faster.
  144.       Also, any setenv statements that just duplicate what's
  145.       in your config.sys can be discarded.
  146.  
  147.       The remaining steps depend on which release of OS/2
  148.       you're running.
  149.  
  150.  
  151. Basic Installation, Part II  (OS/2 1.1):
  152.  
  153.    4. Add csh.exe with the title "Hamilton C shell" to the
  154.       "Start Programs" menu.  To do this, pull-down
  155.       "Program" and select "Add..." from the menu bar.
  156.  
  157.       Fill in:
  158.  
  159.             Program title....   Hamilton C shell
  160.             Path and file name  ....as appropriate....\csh.exe
  161.             Parameters....      -L
  162.  
  163.       The "-L" part tells csh.exe when it starts up that
  164.       it's a "login" shell, which means it should look for
  165.       a login.csh file. (Refer to page (?) for additional
  166.       information on other options.)
  167.  
  168.    5. You will likely want to create a second entry for
  169.       running full-screen. It's more convenient if you're
  170.       mostly working with applications that only run full-
  171.       screen or if you want faster text display, especially
  172.       scrolling.  To do that, from the "Start Programs"
  173.       menu, pull-down "Program" and select "Copy..." from
  174.       the menu bar.  In the Copy Programs popup, fill in the
  175.       following and push the "Copy" button:
  176.  
  177.             Change Title to:    Hamilton C shell -- Full
  178.             Screen
  179.  
  180.       Back in the "Start Programs" window, select the new
  181.       full screen title, pull-down "Program" and select
  182.       "Change...".  In the Change Program Information
  183.       popup, push the "Change" button.  This brings up the
  184.       How to Run the Program popup; select "Run the program
  185.       full-screen" and "Enter".
  186.  
  187.    6. All the material in the samples directory is provided
  188.       for its tutorial value; you may or may not wish to copy
  189.       it onto your hard disk.
  190.  
  191.    7. Reboot your system before starting Hamilton C shell for
  192.       the first time.  This causes the new statements in
  193.       config.sys to take effect.
  194.  
  195.  
  196. Basic Installation, Part II  (OS/2 1.2 or 1.3):
  197.  
  198.    4. Add csh.exe with the title "Hamilton C shell" to the
  199.       "Group - Main" menu.  To do this, pull-down
  200.       "Program" and select "New..." from the menu bar.
  201.  
  202.       Fill in:
  203.  
  204.             Program title:      Hamilton C shell
  205.             Path and file name: ....as appropriate....\csh.exe
  206.             Parameters:         -L
  207.  
  208.       The "-L" part tells csh.exe when it starts up that
  209.       it's a "login" shell, which means it should look for
  210.       a login.csh file. (Refer to page (?) for additional
  211.       information on other options.)
  212.  
  213.    5. You will likely want to create a second entry for
  214.       running full-screen. It's more convenient if you're
  215.       mostly working with applications that only run full-
  216.       screen or if you want faster text display, especially
  217.       scrolling.  To do that, from the "Group - Main" menu,
  218.       pull-down "Program" and select "Copy..." from the
  219.       menu bar.  In the Copy Programs popup, fill in the
  220.       following and push the "Copy" button:
  221.  
  222.             Change Title to:    Hamilton C shell -- Full Screen
  223.  
  224.       Back in the "Group - Main" window, select the new
  225.       full screen title, pull-down "Program" and select
  226.       "Properties..." .  In the Properties popup, push the
  227.       down arrow next to the "Program Type:" box and select
  228.       "OS/2 Full Screen" on the list that will appear and
  229.       then push the "Change" button.
  230.  
  231.    6. All the material in the samples directory is provided
  232.       for its tutorial value; you may or may not wish to copy
  233.       it onto your hard disk.
  234.  
  235.    7. Reboot your system before starting Hamilton C shell for
  236.       the first time.  This causes the new statements in
  237.       config.sys to take effect.
  238.  
  239.  
  240. Basic Installation, Part II  (OS/2 2.0):
  241.  
  242.    4. Open the Templates folder and drag a program object to
  243.       the desktop (or another folder) by pressing and holding
  244.       the right mouse button as you drag.  On the Program
  245.       page of the "Program - Settings" window that will
  246.       appear, fill in:
  247.  
  248.             Path and file name: ....as appropriate....\csh.exe
  249.             Parameters:         -L
  250.  
  251.       The "-L" part tells csh.exe when it starts up that
  252.       it's a "login" shell, which means it should look for
  253.       a login.csh file. (Refer to page (?) for additional
  254.       information on other options.)
  255.  
  256.    5. On the Window page of the Settings, you will probably
  257.       want to set
  258.  
  259.             Minimized button behavior:  Minimize window to
  260.             desktop
  261.  
  262.             Object open behavior:  Create new window
  263.  
  264.       Doing this will let you conveniently open up lots of
  265.       copies of the C shell as needed.
  266.  
  267.    6. On the General page of the Settings, set
  268.  
  269.             Title:              Hamilton C shell
  270.  
  271.       Close the Settings by pressing Alt-F4.
  272.  
  273.    7. You will likely want to create a second entry for
  274.       running full-screen. It's more convenient if you're
  275.       mostly working with applications that only run full-
  276.       screen or if you want faster text display, especially
  277.       scrolling.  To do that, copy the C shell icon you just
  278.       created by right-clicking on it and selecting
  279.       "Copy..." and then choosing an appropriate
  280.       destination folder (probably the desktop) for the copy.
  281.       You can also copy the icon by pressing and holding the
  282.       Ctrl key while dragging with the right mouse button.
  283.  
  284.    8. Once you've made the copy, right-click on it and select
  285.       "Open" and then "Settings".  On the "Session"
  286.       page, select "OS/2 full screen".  Then go to the
  287.       "General" page and type a new title:
  288.  
  289.             Title:              Hamilton C shell
  290.             Full Screen
  291.  
  292.       Close the Settings window for the copy by pressing Alt-F4.
  293.  
  294.    9. All the material in the samples directory is provided
  295.       for its tutorial value; you may or may not wish to copy
  296.       it onto your hard disk.
  297.  
  298.   10. Reboot your system before starting Hamilton C shell for
  299.       the first time.  This causes the new statements in
  300.       config.sys to take effect.
  301.  
  302.  
  303. Installation as the Default Command Processor:
  304.  
  305.    The C shell can also be installed as the default command
  306.    processor OS/2 protected mode, meaning you specify it, not
  307.    cmd.exe in your config.sys.  The principal advantage is that
  308.    when the when the C shell is run as the default command
  309.    processor, PM allows the C shell to change its own title bar
  310.    and, under OS/2 1.3 or 2.0 (but not the 6.167 Beta or LA
  311.    builds), its own icon to show what it's running.  This can
  312.    be quite helpful if you have lots of copies of the shell
  313.    running minimized and would like to know what each one is
  314.    doing.
  315.    
  316.    The disadvantage is that the installation is slightly messy
  317.    and it does disable cmd.exe's ability to change its title
  318.    bar and icon.  For these reasons, most users will want to
  319.    wait until they've gained some familiarity with the C shell
  320.    and with OS/2 before installing it this way.
  321.    
  322.    To install the C shell as the default command processor,
  323.    follow the instructions for the basic installation but then
  324.    make these changes, as appropriate for your system:
  325.  
  326.  
  327.  
  328. Default Command Processor Installation Procedure  (OS/2 1.2 or 1.3):
  329.  
  330.    1. Edit the PROTSHELL line in your config.sys, replacing
  331.       the pathname and any parameters for cmd.exe
  332.       (remembering what they were) with the pathname for the
  333.       C shell and a -L (login) parameter.  The resulting line
  334.       should look something like this:
  335.  
  336.          PROTSHELL=C:\OS2\PMSHELL.EXE C:\OS2\OS2.INI C:\OS2\OS2SYS.INI C:\OS2\BIN\CSH.EXE -L
  337.  
  338.    2. Change the pathname you specify for the C shell in
  339.       Start Programs or Group-Main to * (an asterisk).  Also,
  340.       change the parameters line to be either blank (1.1 or
  341.       1.2) or (1.3):
  342.  
  343.             /K "%*"
  344.  
  345.    3. Change the entries (probably named "OS/2 Window" or
  346.       "OS/2 Full Screen") in Group-Main or Start Programs
  347.       for cmd.exe to fill in the complete pathname for
  348.       cmd.exe instead of an asterisk.  Set the parameters to
  349.       whatever you had specified following the pathname for
  350.       cmd.exe (if anything) in your config.sys before
  351.       changing it in step 1.
  352.  
  353.    4. Change any entries in any of your program groups which
  354.       invoke .cmd scripts to run them via cmd.exe explicitly.
  355.       For example, if you had an entry that specified the
  356.       program "c:\myapp\foo.cmd", change that to:
  357.  
  358.             Path and file name:  c:\os2\cmd.exe
  359.             Parameters: /C c:\myapp\foo.cmd ...any additional
  360.             parameters...
  361.  
  362.    5. Reboot.
  363.  
  364.  
  365. Default Command Processor Installation Procedure  (OS/2 2.0 or 2.1):
  366.  
  367.    1. Edit your config.sys to set OS2_SHELL to point to the C
  368.       shell, specifying the -L (login) option, e.g.,
  369.  
  370.             set  OS2_SHELL=c:\hamilton\bin\csh.exe -L
  371.  
  372.    2. Modify the Settings for the OS/2 Window and OS/2 Full
  373.       Screen icons to show the full path for cmd.exe (e.g.,
  374.       "c:\os2\cmd.exe") rather than an asterisk on the
  375.       Program page.
  376.  
  377.    3. Modify the Settings for the Hamilton C shell icons to
  378.       specify an asterisk pathname (meaning the default
  379.       shell), deleting any mention of any startup parameters
  380.       and explicitly specifying the C shell icon rather than
  381.       the default icon:
  382.  
  383.       a. Right-click on the icon and open the Settings.
  384.  
  385.       b. On the Program page, set
  386.  
  387.                Path and file name: *
  388.                Parameters:
  389.  
  390.       c. Select "Find..." next to the icon display.
  391.  
  392.       d. Select "Locate" on the Find screen.
  393.  
  394.       e. Select the "Path" page on the Locate Folder
  395.          screen.
  396.  
  397.       f. Type the pathname of the directory containing the
  398.          C shell's csh.ico icon file.  (E.g., "c:\hamilton\bin".)
  399.  
  400.       g. Press the "OK" button on the Locate Folder
  401.          screen.
  402.  
  403.       h. Type "csh.ico" in the Name field on the Find
  404.          screen.
  405.  
  406.       i. Press the "Find" button.
  407.  
  408.       j. The Find Results screen should appear with the C
  409.          shell icon highlighted.  Press the "OK" button.
  410.  
  411.       k. Back in the General Settings screen, you should
  412.          now see the C shell's icon.  Press Alt-F4 to close
  413.          the screen.
  414.  
  415.    4. When you reboot, the C shell will be the default shell
  416.       and it will appear with its correct icon both for
  417.       starting and when you minimize it.
  418.