home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / m / ms_sh21c.zip / install < prev    next >
Text File  |  1992-12-14  |  5KB  |  124 lines
  1. Shell Version 2.1    INSTALL                December 1992
  2.  
  3.  MS-DOS SHELL - Copyright (c) 1990,1,2 Data Logic Limited and Charles Forsyth
  4.  
  5.  This code is based on (in part) the shell program written by Charles
  6.  Forsyth and is subject to the following copyright restrictions:
  7.  
  8.  1.  Redistribution and use in source and binary forms are permitted
  9.      provided that the above copyright notice is duplicated in the
  10.      source form and the copyright notice in file sh6.c is displayed
  11.      on entry to the program.
  12.  
  13.  2.  The sources (or parts thereof) or objects generated from the
  14.      sources (or parts of sources) cannot be sold under any circumstances.
  15.  
  16.     $Header: /usr/users/istewart/src/shell/sh2.1/Release/RCS/Install,v 2.1 1992/12/14 11:13:55 istewart Exp $
  17.  
  18.     $Log: Install,v $
  19.     Revision 2.1  1992/12/14  11:13:55  istewart
  20.     BETA 215 Fixes and 2.1 Release
  21.  
  22.     Revision 2.0  1992/04/13  17:40:33  Ian_Stewartson
  23.     MS-Shell 2.0 Baseline release
  24.  
  25.  
  26.     
  27. ________________________________________________________________________________
  28.  
  29. To rebuild and install the shell, you should follow the following the steps:
  30.  
  31. 1)  If you have the binary only version, skip steps 2 through 5.
  32.  
  33. 2)  Load the include files in the include directory into the standard location
  34.     (\msc\include or equivalent).  Read CHANGES file for the additional
  35.     definitions which are required in the standard Microsoft C5 & C6 include
  36.     files and edit them in to the appropriate files.
  37.  
  38.     We have standardised our MSDOS and Unix include files such that the same
  39.     include file exists our Unix system and MSDOS systems.  This makes porting
  40.     a lot easier.  If you don't want to edit the standard include files, you
  41.     will have to generate an new include file for the shell and include it as
  42.     the first include in all the C sources for the additional library functions
  43.     and the Shell itself
  44.  
  45. 3)  Modify the library function open so that the O_NOINHERIT flag is passed to
  46.     MSDOS by the library.  This is not strictly necessary.  I did it using
  47.     CodeView to see where the library function masks the bottom three bits,
  48.     noted the bytes around this location, extracted the open function from the
  49.     library, patched the mask to be 0x83 instead of 0x03, and then replaced
  50.     the function in the library (Also see the Patch.Lib file).
  51.  
  52. 4)  Compile the library files in the directory lib in large model mode and add
  53.     the objects to your large model library
  54.  
  55.     cl -c -AL -Olt *.c
  56.     <appropriate library commands>
  57.  
  58.     Note:   system.c and swap.asm are currently only support large model
  59.         programs.  system.c can be loaded in your library to replace
  60.         the standard Microsoft version.
  61.  
  62.         swap.obj must be the first module on the link line so that it
  63.         is loaded directly after the psp in memory.
  64.  
  65.         cl -AL -o demo swap.obj demo.obj
  66.  
  67.         for example (cf sh0.asm in the shell).
  68.  
  69. 5)  Build the shell, either using make or
  70.  
  71.     For MSDOS:
  72.  
  73.     cl -c -AL -Olt *.c
  74.     masm /Ml sh0.asm
  75.     link sh0+sh1+sh2+sh3+sh4+sh5+sh6+sh7+sh8+sh9+sh10+sh11/noi/noe/stack:0x8000, sh.exe;
  76.  
  77.     Note that the order is important.  SH0.OBJ must be the first object
  78.     file in the load line.
  79.     
  80.     For OS/2:
  81.     cl -o sh -AL -Olt -DOS2 *.c sh.def -F 8000
  82.  
  83. 6)  Install the shell executable in its correct location.  The executable is
  84.     either shdos.exe (for MSDOS 3,4,5) or shos2.exe (for OS/2 1.2..).  Copy
  85.     this file to sh.exe in the correct directory.  If you don't change the
  86.     name, or change the name to something else, you must also change the name
  87.     of sh.ini to the same name.  For example:  shdos.exe is matched with
  88.     shdos.ini and sh210.exe is matched with sh210.ini.
  89.  
  90. 7)  Modify the initialisation file sh.ini for your edit key preferences and
  91.     install it in the same directory as the executable.
  92.  
  93. 8)  Modify the scripts as appropriate for your installation and install
  94.     them in the correct directories.
  95.  
  96.     /profile.sh        - your profile (NOT MINE) in your ${HOME} directory.
  97.     /etc/profile.sh    - your /etc profile (NOT MINE).  This must be /etc on
  98.                   the same disk drive as you start the shell on.
  99.               Ie.  if you are in c:/bin when you start the
  100.               shell, this must be in c:/etc/profile.sh.  If you
  101.               are in f:/tools/sh200 when you start the shell,
  102.               this must be in f:/etc/profile.sh.
  103.     sh.rc        - your ${ENV} file (NOT MINE).  Anywhere as long as
  104.               ${ENV} in either ${HOME}/profile or /etc/profile
  105.               declare the variable.
  106.  
  107.               Note:  This file is usuful for selecting the swap
  108.                  mode on startup.
  109.  
  110.     extend.lst          - your Extended command line processing file (NOT MINE).
  111.                   Anywhere as long as ${EXTENDED_LINE} in either
  112.               ${HOME}/profile or /etc/profile declares the file.
  113.  
  114. 9)  Type "sh -0" and see what happens.
  115.  
  116. 10) If you have problems, check that the environment variables are set
  117.     correctly.  Use the set command under the MSDOS command.com and in the
  118.     shell.
  119.  
  120.     Remember that some commands require DOS format file names and environment
  121.     variables.  So check the setting of these variables (using the shell's
  122.     msdos command) and the entries in ${EXTENDED_LINE}.
  123.  
  124.