home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / SH164X.ZIP / README < prev    next >
Text File  |  1990-09-07  |  5KB  |  148 lines
  1.  MS-DOS Shell Version 1.6    README                April 1990
  2.  
  3.  MS-DOS SHELL - Copyright (c) 1990 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:/SRC/SHELL/RCS/readme 1.8 90/08/15 01:18:53 MS_user Exp $
  17.  
  18.     $Log:    readme $
  19.     Revision 1.8  90/08/15  01:18:53  MS_user
  20.     Add 1.6.3 comment
  21.  
  22.     Revision 1.7  90/04/03  18:07:01  MS_user
  23.     Some changes for 1.6 (Int 24 and Config file)
  24.  
  25.     Revision 1.6  90/03/14  12:37:23  MS_user
  26.     Add some more 1.6 changes
  27.  
  28.     Revision 1.5  90/03/06  17:01:00  MS_user
  29.     1.6 release
  30.  
  31.     Revision 1.4  90/02/22  16:52:41  MS_user
  32.     Add XMS support
  33.  
  34.     Revision 1.3  90/02/16  16:58:10  MS_user
  35.     Set up 1.5 release
  36.  
  37.     Revision 1.2  90/02/14  04:53:20  MS_user
  38.     Interrupt 24 note
  39.  
  40.     Revision 1.1  90/01/25  13:43:20  MS_user
  41.     Initial revision
  42.  
  43. ________________________________________________________________________________
  44.  
  45. This is an implementation of the Unix Shell for MSDOS.  As far as
  46. possible it is compatible with the System V.3 program sh(1).  The
  47. following differences are noted:
  48.  
  49. 1)  Background or asynchronous commands are not supported
  50.  
  51. 2)  Certain internal commands which have no equivalent MSDOS supported
  52.     functionality support (ulimit, time etc) are not provided.
  53.  
  54. 3)  Command hashing and accounting are not supported.
  55.  
  56. 4)  The Shell uses all variables starting with a ~ (tilde) internally
  57.     and will not allow you to display them.  I don't think this is a
  58.     difference from the user's view, just internally.
  59.  
  60. 5)  8 bit character sets are not supported.
  61.  
  62. The following enhancements have been made for the MSDOS environment.
  63. These enhancements are described in the appropriate section of the
  64. manual pages.
  65.  
  66. 1)  The Shell will swap itself out to one of the following:
  67.  
  68.     - Expanded memory
  69.     - Extended memory
  70.     - Disk (this is the slowest)
  71.  
  72.     The swapping is controlled by the shell internal command swap.  If
  73.     swapping is enabled, the shell only uses 3K of memory whilst a
  74.     child process is executing.
  75.  
  76.     Note: Swapping to Extended memory is probably the most dangerous
  77.       unless you have an XMS memory manager available.  The shell
  78.       requires the XMS manager to support the version 2 XMS
  79.       specification.
  80.  
  81. 2)  History processing has been added.
  82.  
  83. 3)  Command line editing has been added.  A configuration file (sh.ini)
  84.     allows the Command Line editing keys to be tailored to the users
  85.     requirements
  86.  
  87. 4)  The command line prompt can be programmed to display 'useful'
  88.     information.
  89.  
  90. 5)  The shell uses Unix format file names (ie slashes and not
  91.     backslashes) to delimit directories.  Some programs require certain
  92.     environment variables to be in MS-DOS format (using backslashes).
  93.     The msdos command allows these variables to be marked so that they
  94.     are set correctly when the environment for a program is set up.
  95.  
  96. 6)  Extended command line processing is supported using the parameter
  97.     @<filename> to a command.  Examples of this include the Microsoft
  98.     Linker and Librarian and of course the Shell itself.  A version of
  99.     stdargv.c which supports this format (and wildcards from a normal
  100.     command line) is included.
  101.  
  102. 7)  Wild cards on drives (ie echo *:*.c will echo all the C files in
  103.     the current directories of each drive) are supported.
  104.  
  105. 8)  Full Interrupt 24 processing has been added.
  106.  
  107. 9)  Filename completion has been added.
  108.  
  109. 10) Alternate command interpreters are supported in shell scripts a la
  110.     Unix V.4.
  111.  
  112. 11) A configuration file is supported to allow edit key specification.
  113.  
  114. 12) The support of POSIX P1003.2 commands has been started.
  115.  
  116. The shell was built using MS-DOS C and MASM v5.1 in large model mode.
  117.  
  118. In order to rebuild this program, you need the DIRECTORY(3) functions
  119. for MSDOS (also included) and the version of open in your library must
  120. pass the O_NOINHERIT bit on the MSDOS kernel.  The Microsoft C V5.1
  121. library does not pass this bit on to the MSDOS open System call.  I
  122. fixed this using CodeView to find where the library function masks off
  123. the bottom 2 bits.  Extracted the object from the library and patched
  124. mask from 0x03 to 0x83 in the object and reload into the library.  No
  125. Problem.  The Patch.Lib document describes the process in more detail.
  126.  
  127. You can do want you like with this software as long as you don't sell
  128. it or remove the Copyright notices in the sources or object.
  129.  
  130. If you have any problems or want to let me know about any enhancements
  131. you have made (which could be included in a new general release), you
  132. can contact me at
  133.  
  134.     Data Logic Limited
  135.     Queens House
  136.     Greenhill Way
  137.     Harrow
  138.     Middlesex, HA1 1YR
  139.     UK.
  140.  
  141.     Phone : +44 1 863 0383
  142.     E-Mail: istewart@datlog.co.uk or ukc!datlog!istewart
  143.  
  144. Note:
  145.     Unix is a registered trademark of AT&T Bell Laboratories
  146.     Microsoft, MSDOS and CodeView are registered trademarks of Microsoft
  147.     Corporation
  148.