home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / sysutils / msshell / install < prev    next >
Text File  |  1992-06-20  |  5KB  |  116 lines
  1. Shell Version 2.0    INSTALL                April 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: c:/usr/src/shell/RCS/install 2.0 1992/04/13 17:40:33 Ian_Stewartson Exp $
  17.  
  18.     $Log: install $
  19.     Revision 2.0  1992/04/13  17:40:33  Ian_Stewartson
  20.     MS-Shell 2.0 Baseline release
  21.  
  22.  
  23.     
  24. ________________________________________________________________________________
  25.  
  26. To rebuild and install the shell, you should follow the following the steps:
  27.  
  28. 1)  If you have the binary only version, skip steps 2 through 5.
  29.  
  30. 2)  Load the include files in the include directory into the standard location
  31.     (\msc\include or equivalent).  Read CHANGES file for the additional
  32.     definitions which are required in the standard Microsoft C5 & C6 include
  33.     files and edit them in to the appropriate files.
  34.  
  35.     We have standardised our MSDOS and Unix include files such that the same
  36.     include file exists our Unix system and MSDOS systems.  This makes porting
  37.     a lot easier.  If you don't want to edit the standard include files, you
  38.     will have to generate an new include file for the shell and include it as
  39.     the first include in all the C sources for the additional library functions
  40.     and the Shell itself
  41.  
  42. 3)  Modify the library function open so that the O_NOINHERIT flag is passed to
  43.     MSDOS by the library.  This is not strictly necessary.  I did it using
  44.     CodeView to see where the library function masks the bottom three bits,
  45.     noted the bytes around this location, extracted the open function from the
  46.     library, patched the mask to be 0x83 instead of 0x03, and then replaced
  47.     the function in the library (Also see the Patch.Lib file).
  48.  
  49. 4)  Compile the library files in the directory lib in large model mode and add
  50.     the objects to your large model library
  51.  
  52.     cl -c -AL -Olt *.c
  53.     <appropriate library commands>
  54.  
  55.     Note:   system.c and swap.asm are currently only support large model
  56.         programs.  system.c can be loaded in your library to replace
  57.         the standard Microsoft version.
  58.  
  59.         swap.obj must be the first module on the link line so that it
  60.         is loaded directly after the psp in memory.
  61.  
  62.         cl -AL -o demo swap.obj demo.obj
  63.  
  64.         for example (cf sh0.asm in the shell).
  65.  
  66. 5)  Build the shell, either using make or
  67.  
  68.     For MSDOS:
  69.  
  70.     cl -c -AL -Olt *.c
  71.     masm /Ml sh0.asm
  72.     link sh0+sh1+sh2+sh3+sh4+sh5+sh6+sh7+sh8+sh9+sh10+sh11/noi/noe/stack:0x8000, sh.exe;
  73.  
  74.     Note that the order is important.  SH0.OBJ must be the first object
  75.     file in the load line.
  76.     
  77.     For OS/2:
  78.     cl -o sh -AL -Olt -DOS2 *.c sh.def -F 8000
  79.  
  80. 6)  Install the shell executable in its correct location.
  81.  
  82. 7)  Modify the initialisation file sh.ini for your edit key preferences and
  83.     install it in the same directory as the executable.
  84.  
  85. 8)  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. 9)  Type "sh -0" and see what happens.
  107.  
  108. 10) 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.