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