home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsr / shell3a / SHELL3A.HLP (.txt) < prev    next >
Psion Database  |  1995-04-17  |  8KB  |  199 lines
  1. OPLDatabaseFile
  2. Shell3a
  3. Introduction
  4. Commands
  5.     Filenames
  6. Redirection of output
  7. History    
  8. alias 
  9. history
  10. mkdir
  11. pause
  12. rename    
  13. rehash    
  14. rescan
  15. rmdir
  16. unalias
  17. which*
  18. 'This program provides some of the basic+
  19. (functions of the shells found on UNIX or*
  20. 'DOS workstations. Basic file operations*
  21. 'are supported (move, copy, delete, etc),
  22. )and output redirection. Input redirection'
  23. $and pipes have not been implemented.+
  24. (There are 28 built in commands which are/
  25. ,listed alphabetically below. If a command is,
  26. )entered that isn't one of these 'builtin'.
  27. +functions, the 'path' is searched for files*
  28. 'matching the command. If a directory is/
  29. ,found instead, the current working directory.
  30. +is set to this. Thus you can enter commands-
  31. *such as 'a:' to change to drive 'a' of the
  32. current device. 
  33. +(Please read the README file for details on
  34.  adding new commands),
  35. )Where ever a filename is specified as the*
  36. 'argument to a command, either a full or"
  37. relative pathname can be given.
  38. -e.g. If the current directory is loc::m:/bat,.
  39. +       the following commands will have the
  40.        same effect:
  41.        -
  42. *       cp loc::m:/bat/*.bat loc::m:/store/
  43.        cp *.bat /store/ 
  44.        cp /bat/*.bat ../store
  45.        etc.&
  46. #For many commands the output can be-
  47. *sent to a file instead of the screen. This
  48. is achieved by:
  49. ('command > file'  OR   'command >> file'
  50. +These are identical except that if the file.
  51. +exists, ">>" appends the output to the file,
  52. )and ">" trucates the file before writing.(
  53. %The most recent 10 commands typed are,
  54. )stored in the history. These are accessed#
  55.  by using the up/down arrow keys.#
  56.  Usage: alias [string1] [string2]
  57. &With no arguments displays the current,
  58. )aliases. With a single arguemnt, displays2
  59. /the alias defined (if it exists) for <string1>./
  60. ,With 2 arguments, the alias for <string1> is
  61. defined as <string2>.
  62.     Usage: bg
  63. #Puts the shell into the background.!
  64. Usage: cat <file1> <file2) ...
  65. ,Without arguments, this reads input from the1
  66. .keyboard a line at a time and displays this to.
  67. +the screen. Input is terminated by pressing
  68. <ESC> on an empty line./
  69. , This command is only really useful when the2
  70. / output is redirected to a file. Then it can be.
  71. + used to concatenate files together, or add0
  72. - text to the end of a file from the keyboard.
  73. Usage: cd <directory>
  74. &Changes the current working directory.
  75. Usage: cls
  76. #Clears the screen (pretty obvious).#
  77.  Usage: cp <source> <destination>
  78. 0Copies the source file either to the destination7
  79. 4file, or if the destination is a directory it copies 
  80. the file iinto the directory.
  81. Usage: date
  82. #Displays the current time and date.
  83. Usage: df [directory]
  84. * With no arguments prints a summary of all
  85. connected devices..
  86. + With a filename as an argument it displays+
  87. (detailed information about the device on
  88. which this resides.
  89. Usage: echo "text"
  90. ?    1Outputs the specified text to the screen. Without%
  91. ?    "arguments blank line is displayed.
  92. Usage: edit <filename>
  93. 7    2Calls up the Psion word application in text editor
  94. mode.
  95. Usage: eval <expression>
  96. )Performs an OPL 'eval' on the expression.
  97. Usage: exec <filename>
  98. )Translated OPL files which conform to the.
  99. +shell3a interface can ONLY be run by typing-
  100. *their name (without the .OPO extension) at*
  101. 'the command line. However for other OPO.
  102. +modules this command will execute the code,(
  103. %albeit without command line arguments
  104. Usage: history
  105. 'Displays the last 10 commands typed in,,
  106. )together with their history number on the
  107. left side of the display.
  108. Usage: ls [-l] [filename]
  109. .If 'filename' is a directory, files within the,
  110. )directory are listed, otherwise filenames,
  111. )matching the specification 'filename' wil2
  112. / be listed. If no filename is given the current
  113.  directory is listed.
  114.      Options:*
  115. '  -l Display modification time and file"
  116.      attributes for each entry.
  117. Usage: man [command]
  118. )With no arguments brings up the top-level0
  119. -help screen. With the name of a valid builtin-
  120. *command, it will display the help text for
  121. that command.
  122. Usage: mkdir <directory>
  123.  Creates the specified directory.
  124. Usage: mv <file1> <file2>,
  125. )         or  mv <file1> <file2> ... <dir>
  126. /In the first form, the source file is copied to1
  127. .the destination, and then deleted. This is the)
  128. &same as the rename command, except you!
  129. can move files across devices.-
  130. * In the second form, one or more files are/
  131. ,copied into the destination, which should be
  132. a directory.
  133. Usage: pause <interval>
  134. )Pauses for a time determined by the value2
  135. /specified. If the interval is 0 or not supplied0
  136. -the program will wait until a key is pressed.1
  137. . If the interval is positive, the program will.
  138. +pause for interval/20 seconds. If the value/
  139. ,is negative, the program can also be started
  140. by a key press.
  141. Usage: pwd
  142. 'Displays the current working directory. 
  143. Usage: rename <file1> <file2>
  144. Usage: rehash
  145. 'Searches the PATH variable for .OPO and+
  146. (.BAT files and stores the commands found-
  147. *in an internal list. This list is searched*
  148. 'when a command entered doesn't match an
  149. alias or built-in command..
  150. + This is run automatically when the path is
  151.      changed.
  152. Usage: rescan
  153. $Check for any attached devices. This$
  154. !command must be used in order for)
  155. &newly attached devices to be accessed.'
  156. $Please note that this command resets'
  157. $the current working directory on all
  158. devices.
  159. Usage: rm <file>
  160. Deletes the specified files.
  161. Usage: rmdir <directory>
  162.  Deletes the specified directory. 
  163. Usage: set [variable] [value]
  164. =<With no arguments the current values of all the variables isD
  165. =Adisplayed. If a variable is specified, only it's current value is
  166. displayed.
  167. =$The following variables are defined:
  168. =0Name              Values             DescriptionF
  169. =C-------------------------------------------------------------------G
  170. =Dappend         ON or OFF    If ON, output redirection using '>' willV
  171. =S                                                  act as though '>>' was specified.G
  172. =Dstatus          ON or OFF    If ON, the Psion status panel is shown.N
  173. =Kunix                ON or OFF    If ON, '/', rather than '\' is used as theH
  174. =E                                                  filename separator.K
  175. =Hprompt         string             Defines the string printed to the leftZ
  176. =W                                                  of the command input. %H includes theX
  177. =U                                                  current history number, %P includesV
  178. =S                                                  the current working directory, %pX
  179. =U                                                  includes a shortened version of %P.H
  180. =E                                                  %% prints a % sign.O
  181. =Lpath               string            Specifies the search path for files andZ
  182. =W                                                  directories. The current directory isZ
  183. =W                                                  included automatically but not shown.G
  184. =Dhelppath      string            Specifies the path to search to findD
  185. =A                                                  this help file.K
  186. =Hfont                font style   Specifies the font and style to use. If]
  187. =Z                                                  the style is not specified, the existing]
  188. =Z                                                  one is used. If the font is specified asM
  189. =J                                                  '-1', it is not changed.
  190. Usage: unalias <string>
  191. ,Removes the alias for <string> if it exists.
  192. Usage: ver
  193. !Displays the version of the shell
  194. Usage: which <command>
  195. )For the supplied command gives either the2
  196. /alias information, identifies it as a buillt-in(
  197. %function or gives the pathname of the
  198. external command.
  199.