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