home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsr / shell3a / README.TXT < prev    next >
Text File  |  1995-04-17  |  5KB  |  119 lines
  1.                     Shell3a V1.23
  2.                     =============
  3.                     
  4.               Copyright (c) Nick Murray 1995
  5.                        
  6.                     
  7. Introduction
  8. ------------
  9.  
  10. Shell3a is a command line shell for the Psion Series 3a. This is
  11. the second general release.
  12.  
  13. Highlights: command aliasing
  14.             command history
  15.             relative pathnames (. ..)
  16.             wildcards (e.g. cp *.bat a:\bat)
  17.             output redirection to a file (e.g. ls > ls.out)
  18.       <NEW> use of cursor keys to scan the command history
  19.       <NEW> support for external commands
  20.  
  21. Commands: alias, bg, cat, cd, chmod, cls, cp, date, df, echo,
  22.           edit, eval, exec, history, ls, man, mkdir, more, mv,
  23.           od, pause, ps, pwd, rehash, rescan, rename, rm, rmdir,
  24.           set, unalias, ver, which
  25.  
  26. More detailed information is contained within the program's help
  27. system. The help system is based on Tom Dolbilin's OPL Help System,
  28. so if you've already installed this you won't need sys$help.opo.
  29.  
  30.  
  31. Installation
  32. ------------
  33.  
  34. (1) Copy the SHELL3A.OPA to \APP\SHELL3A.OPA on A: B: or M:
  35. (2) Copy the AUTOEXEC.BAT to the root directory \ on A: B: or M:
  36. (3) Install SHELL3A.OPA onto the desktop using PSION-I
  37. [the rest of the installation can be performed using the shell]
  38. (4) Create a directory \BIN and copy all the .OPO files into it.
  39. (5) Create a directory \HLP and copy all the .HLP files into it.
  40.  
  41.  
  42. Customisations (usually set in AUTOEXEC.BAT)
  43. --------------
  44. (1) PATH - This is the list of directories in which the shell will
  45.    look for .BAT and .OPO files. For speed, each time the PATH is
  46.    changed (or explicitly with the REHASH command), a list of OPO
  47.    and BAT files is stored. The commands stored in the PATH are
  48.    accessed without the .BAT or .OPO suffix.
  49.     .OPO and .BAT files can be executed if they aren't in the
  50.    PATH by giving their full path (Note that any OPO modules
  51.    must adhere to the specifications set out in the PROGRAM.TXT
  52.    document. To run OPOs not written for use with this shell, use
  53.    the EXEC command).
  54.     SYS$HELP.OPO must be in one of the directories of the PATH.
  55.  
  56.  (2) HELPPATH - The directory in which the help files are stored.
  57.    If help is invoked on a command, eg. mycom, that isn't built
  58.    into the shell a help file 'MYCOM.HLP' is searched for in the
  59.    directory. This allows help to be provided for user-supplied
  60.    commands.
  61.  
  62. Other files included:
  63.  Readme.txt - this file
  64.  Autoexec.bat - sample setup file
  65.  Dos.bat - a file containing aliases more familiar to MS-DOS users.
  66.            You can either add these to the autoexec.bat file or
  67.            simply type 'dos' from within the shell providing the
  68.            file is in the search path.
  69.  Program.txt - Details of how to write external modules.
  70.  More.opo, Od.opo, Chmod.opo, Ps.opo - external modules. 
  71.  More.hlp, Od.hlp, Chmod.hlp, Ps.hlp, Shell3a.hlp - help files.
  72.  Rm.opl - example source of an external module
  73.  Sys$help.opo, Hcp.opo - Tom Dolbilin's OPL Help System
  74.  
  75.  
  76. New features in this version
  77. ----------------------------
  78. - Items in the command history are accessed using the up/down
  79.  cursor keys
  80. - The <Help> key brings up the main help menu.
  81. - Support for external modules and hence user-expansion of the
  82.  capabilities of the shell.
  83.  
  84. Changes between V1.23 and V1.02
  85. -------------------------------
  86. - The comment string in .BAT files is now '#'
  87. - The Mac 3-link can now be used. Pathnames and device names with
  88.  spaces have to be quoted, eg. cd "rem::Hard Disk:".
  89. - The PATH is no longer searched each time a command that doesn't
  90.  match a built-in is found. Instead a list of .OPO of .BAT files
  91.  found in the path is stored and searched. This means external
  92.  .OPO modules are executed with little noticable delay. Members of
  93.  the list are accessed WITHOUT the suffix .BAT or .OPO.
  94. - Separate current directory for each device. Because of this
  95.  all possible devices are scanned when theprogram starts. If
  96.  devices are added the command 'rescan' must be used to recognize
  97.  the new device. Note the rescan command has the side-effect of
  98.  resetting the current working directory.
  99. - 'df' without arguments show a summary of all devices
  100.  
  101.  
  102. Bugs, suggestions, etc.
  103. -----------------------
  104. I can be reached via email at nmurray@csd.abdn.ac.uk
  105.  
  106.  
  107. Disclaimer
  108. ----------
  109. The author of this software is not responsible for any damage due
  110. to use of this program. This software is provided without warranty
  111. of any kind.
  112.  
  113.  
  114. Copyright
  115. ---------
  116. Last and by no means least, this program is NOT public domain and I
  117. retain the copyright. However provided you don't make money from it
  118. this program is freely distributable.
  119.