home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / dossh23.zip / README.TXT < prev    next >
Text File  |  2002-10-01  |  7KB  |  170 lines
  1.  MS-DOS Shell Version 2.3    README                September 1994
  2.  
  3.  MS-DOS SHELL - Copyright (c) 1990,4 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/shell/sh2.3/Release/RCS/ReadMe,v 2.3 1994/08/25 20:58:47 istewart Exp $
  17.  
  18.     $Log: ReadMe,v $
  19.     Revision 2.3  1994/08/25  20:58:47  istewart
  20.     MS Shell 2.3 Release
  21.  
  22.     Revision 2.2  1993/12/03  13:32:52  istewart
  23.     Release 2.2
  24.  
  25.     Revision 2.1  1992/12/14  11:14:32  istewart
  26.     BETA 215 Fixes and 2.1 Release
  27.  
  28.     Revision 2.0  1992/04/13  17:40:33  Ian_Stewartson
  29.     MS-Shell 2.0 Baseline release
  30.  
  31.     
  32. ________________________________________________________________________________
  33.  
  34. This is an implementation of the Unix Shell for MSDOS.  As far as possible it
  35. is compatible with the System V.4 program sh(1) with ksh(1) extension.  The
  36. following differences are noted:
  37.  
  38. 1)  Background or asynchronous commands are not supported under MSDOS.  Some
  39.     support is provided under OS/2, but it is not as full as UNIX.  You can
  40.     only run one command and not a pipeline in background.
  41.  
  42. 2)  Certain internal commands which have no equivalent MSDOS or OS/2 supported
  43.     functionality support (ulimit, time etc) are not provided.
  44.  
  45. 3)  Command hashing and accounting are not supported.
  46.  
  47. 4)  Some of the ksh functionality has not yet been implemented or made ksh
  48.     compatible (see Notes file).
  49.  
  50. 5)  The Shell uses all variables starting with a ~ (tilde) internally and will
  51.     not allow you to display them.  I don't think this is a difference from
  52.     the user's view, just internally.
  53.  
  54. The Shell has been tested mainly under MSDOS 3.3, 4.01, 5.2, 6.0 and 6.2, OS/2
  55. 1.3, 2.0 and 2.1, and a prelimiary version can be built for Windows NT 3.1
  56. (see notes files on this).  It has exposed some shortcomings in the C6.0
  57. compiler and MSDOS library.  As such, using C5.1 and its library are prefered
  58. when re-building the shell for MSDOS.
  59.  
  60. The following enhancements have been made for the MSDOS environment.  These
  61. enhancements are described in the appropriate section of the manual pages.
  62.  
  63. 1)  Under MSDOS (16-bit version), the Shell will swap itself out to one of
  64.     the following:
  65.  
  66.     - Expanded memory
  67.     - Extended memory
  68.     - Disk (this is the slowest)
  69.  
  70.     The swapping is controlled by the shell internal command swap.  If
  71.     swapping is enabled, the shell only uses 3K of memory whilst a child
  72.     process is executing.
  73.  
  74.     Note: Swapping to Extended memory is probably the most dangerous unless
  75.       you have an XMS memory manager available.  The shell requires the
  76.       XMS manager to support the version 2 XMS specification.
  77.  
  78. 2)  Command line editing has been added for non VI or EMACS mode.  A
  79.     configuration file (sh.ini) allows the Command Line editing keys to be
  80.     tailored to the users requirements.
  81.  
  82. 3)  The command line prompt can be programmed to display 'useful' information.
  83.  
  84. 4)  The shell uses Unix format file names (ie slashes and not backslashes) to
  85.     delimit directories.  Some programs require certain environment variables
  86.     to be in MS-DOS format (using backslashes).  The msdos or typeset -H
  87.     commands allows these variables to be marked so that they are set correctly
  88.     when the environment for a program is set up.
  89.  
  90. 5)  The format of the command line which the shell passes to a program is
  91.     configurable between normal, indirect files and environment variables
  92.     (see SH.1).  A version of stdargv.c which supports the indirect file
  93.     format (and wildcards from a normal command line) is included.
  94.  
  95. 6)  Wild cards on drives (ie echo *:*.c will echo all the C files in the
  96.     current directories of each drive) are supported.
  97.  
  98. 7)  Full Interrupt 24 processing has been added.
  99.  
  100. 8)  Alternate command interpreters are supported in shell scripts a la
  101.     Unix V.4.
  102.  
  103. 9)  A number of OS/2 internal commands (start, detach) have been addded.
  104.  
  105. 10) The Notes file describes the fixes and changes between Release 2.2 and
  106.     2.3
  107.  
  108. 11) Significant parts of the shell have been re-written this release 2.1.
  109.  
  110.  
  111. The following Bugs are known to exist in the Shell.
  112.  
  113. 1)  See Notes file.
  114.  
  115. 2)  I may have mis-interpreted the functionality of either the UNIX version
  116.     of sh or ksh (tell me about it).
  117.  
  118. The shell was built using Microsoft C 5.1 and MASM v5.1 in large model mode
  119. for MSDOS and Microsoft C6.0 for OS/2 (16 bit) and WATCOM 9 for both 32-bit
  120. versions (although EMX GCC 2.5 is supported for the 32 Bit version under
  121. OS/2).
  122.  
  123. In addition, the version of open in your library must pass the O_NOINHERIT bit
  124. on the MSDOS kernel.  The Microsoft C v5.1 library (and possibly the v6.0) does
  125. not pass this bit on to the MSDOS open System call.  I fixed this using CodeView
  126. to find where the library function masks off the bottom 2 bits.  Extracted the
  127. object from the library and patched mask from 0x03 to 0x83 in the object and
  128. reload into the library.  No Problem.  The Patch.Lib document describes the
  129. process in more detail.
  130.  
  131. You can do want you like with this software as long as you don't sell it or
  132. remove the Copyright notices in the sources or object.
  133.  
  134. If you have any problems or want to let me know about any enhancements, I'd
  135. love to hear about them.  However, following this release, I will be leaving
  136. Data Logic in the middle of September 94.  I will not have an E-Mail address
  137. at my new company, until I arrange a personal account in the New Year.  I
  138. expect to be in Europe for three months and will not arrange the personal
  139. account until I return.  You should be able to contact me by surface mail
  140. at the address below, but don't expect a rapid response.
  141.  
  142.     Ian Stewartson
  143.     OSI Group
  144.     Metropolis House
  145.     22 Percy Street
  146.     London W1P 9FF
  147.     United Kingdon.
  148.  
  149. Please don't contact Data Logic as it is unlikely have anyone there will
  150. know anything about the shell. 
  151.  
  152. Note:
  153.     Unix is a registered trademark of AT&T Bell Laboratories
  154.     Microsoft, MSDOS, MASM, MS Windows, Windows NT and CodeView are registered
  155.     trademarks of Microsoft Corporation
  156.     OS/2 is a registered trademark of Internation Business Machines Corporation
  157.  
  158. Acknowledgements:
  159.  
  160. This program is based on ideas, code or parts of code developed by:
  161.  
  162.     David Korn and Steve Bourne (the original ideas)
  163.     Charles Forsyth (original source for the MINIX Shell program)
  164.     Erik Baalbergen (original source for the MINIX test program)
  165.     Paul Falstad (original source for the maths functions from GNU zsh program)
  166.     Simon J. Gerraty (the code for the new lexical analyser and the VI/EMACS
  167.     edit functions).
  168.  
  169.     Ideas and fixes from lots of others.
  170.