home *** CD-ROM | disk | FTP | other *** search
/ PSION CD 2 / PsionCDVol2.iso / Programs / 282 / README.TXT < prev    next >
Text File  |  1998-03-02  |  5KB  |  126 lines
  1.                     Shell5 V2.0 beta 2
  2.                     ==================
  3.  
  4.               Copyright (c) Nick Murray 1998
  5.  
  6.  
  7. Introduction
  8. ------------
  9.  
  10. Shell5 is a command line shell for the Psion Series 5 which
  11. allows basic file operations such as copy, delete, rename, etc,
  12. as well as more sophisticated operations.
  13.  
  14. Highlights:
  15.       User-defined keys/macros
  16.       Filename completion via the Tab key
  17.       "Time" command for measuring the execution time for commands
  18.       A 'pipe' like feature allowing the output of one command to
  19.        form the input of another
  20.       Command history accessed with the cursor keys
  21.       Multiple commands per line, separation by ';'
  22.       Support for external, user written, commands
  23.       Access to ROM (Z:) filesystems
  24.       Relative pathnames (. ..)
  25.       Wildcards on filenames (e.g. cp *.bat a:\bat)
  26.       Command aliasing
  27.       Redirection of command input and output (e.g. ls > ls.out)
  28.       Shell variables, allowing extensive configuration
  29.       Support for batch files including parameter passing and the
  30.        additional commands IF, GOTO and SHIFT
  31.       Ability to run .OPO and .APP files (inc. parameters)
  32.       Pop-up error log window
  33.       Inline arithmetic evaluation, e.g. echo 1+1 is ${1+1}
  34.       Sophisticated 'path' mechanism
  35.       Extensive help
  36.       Full source code available
  37.       Distributed under the GNU General Public License
  38.  
  39. Commands: alias, at, banner, bg, bindkey, cat, cd, chmod, cls, cp, date,
  40. (Builtin) df, dirs, echo, edit, exit, goto, hash, help, history, if, log, 
  41.           ls, mkdir, more, mv, od, pause, popd, pushd, pwd, rename,
  42.           rescan, rm, rmdir, set, shift, sysinfo, time, unalias, unset,
  43.           ver, which
  44.  
  45. Supplied as external modules:
  46.   backlight, charset, compact, contrast, du, getclip, play, putclip, wc
  47.  
  48. More detailed information is contained within the program's help
  49. system and visit the WWW site at:
  50.  
  51.      http://www.geocities.com/SiliconValley/Pines/1439/shell.html
  52.  
  53.  
  54. Installation
  55. ------------
  56. Unzip the file sh5_20b2.zip
  57. Copy the Shell5 directory to \System\Apps on c: or d:
  58. - this includes the application, .aif file,the default autoexec.bat,
  59.   the help files in the "help" subdirectory and supplied external
  60.   commands (.OPO) in the "bin" subdirectory.
  61. If you haven't already installed Psion's sysram1.opx (many applications
  62. use this) copy the file Sysram1.opx to the directory \System\Opx,
  63. creating the directory if necessary.
  64.  
  65.  
  66. Customising the installation
  67. ----------------------------
  68. On startup, the program queries its pathname and looks for a file
  69. "autoexec.bat" (which should only contain Shell5 commands) in the same
  70. directory which it then executes. The shell variable $_syspath is also
  71. set to this directory. The path variable (the list of directories the
  72. shell searches to find external commands) defaults to $_syspath\bin,
  73. and the helppath variable (the list of directories the shell searches
  74. to find help files) defaults to $_syspath\help.
  75.  Both of these variables can be reset in autoexec.bat.
  76.  
  77.  
  78. Files included
  79. --------------
  80. Shell5\autoexec.bat
  81. Shell5\shell5.aif
  82. Shell5\shell5.app
  83. Shell5\help\external.hlp
  84. Shell5\help\shell5.hlp
  85. Shell5\bin\backlight.opo
  86. Shell5\bin\charset.opo
  87. Shell5\bin\contrast.opo
  88. Shell5\bin\compact.opo
  89. Shell5\bin\du.opo
  90. Shell5\bin\getclip.opo
  91. Shell5\bin\putclip.opo
  92. Shell5\bin\play.opo
  93. Shell5\bin\wc.opo
  94. Readme.txt - this file
  95. Program.txt - a description of how to write external commands
  96. Copying.txt - GNU General Public Licence
  97. Changes.txt - recent changes to the program
  98. Sysram1.opx - Additional System functions .OPX (written by Psion)
  99.  
  100. Source is always available (in both OPL and text formats) at the WWW
  101. site listed below. If you have difficulties obtaining the files from
  102. that site, email me at the address below and I'll email you the
  103. source.
  104.  
  105.  
  106. External Commands
  107. -----------------
  108. If you write any useful external commands that you'd like to make
  109. available to other users, either send me the source or drop me a
  110. note of where it's available, and I'll include this information in
  111. the next release.
  112.  
  113.  
  114. Bugs, suggestions, etc.
  115. -----------------------
  116. I can be reached via email at nick-murray@geocities.com and visit
  117. the WWW page: http://www.geocities.com/SiliconValley/Pines/1439/shell.html
  118.  
  119.  
  120. Distribution and Warranty
  121. -------------------------
  122. This software comes with ABSOLUTELY NO WARRANTY; for details see the file
  123. Copying.txt, Sections 11 and 12. This is free software, and you are
  124. welcome to distribute it under certain conditions; again, for details see
  125. the file Copying.txt.
  126.