home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / a / armedit / Docs / OSCLI < prev    next >
Text File  |  1997-02-21  |  3KB  |  89 lines
  1. File        : OSCLI
  2. Date        : 21-Feb-97
  3. Author      : © A.Thoukydides, 1995, 1996, 1997
  4. Description : Description of the PC OSCLI command that is part of the ARMEdit
  5.               suite.
  6.  
  7.  
  8. INTRODUCTION
  9.  
  10. The "OSCLI" command allows RISC OS *commands to be executed from the DOS
  11. command line. To use this command it is necessary to load the ARMEdit module
  12. before starting the PC front-end.
  13.  
  14.  
  15. USAGE
  16.  
  17. The syntax is:
  18.  
  19.     OSCLI [/?] [/S|/I] <Command>
  20.  
  21. where
  22.  
  23.     /?          - Displays some help text.
  24.     /S          - Prevents redirection of output through DOS.
  25.     /I          - Redirects both input and output streams through DOS.
  26.     <Command>   - The command to execute.
  27.  
  28. Note that to prevent DOS from changing the command it is a good idea to place
  29. it in quotation marks.
  30.  
  31. Due to the way in which this command operates, strange behaviour can
  32. sometimes be produced. Some RISC OS commands can cause the computer to crash,
  33. so be careful with it. In particular, the commands are executed within the
  34. environment of the PC front-end, so applications must not be started.
  35.  
  36. Another point to note is that commands that require action to be taken by a
  37. WIMP task, such as Filer_Run will not take effect until the PC enters
  38. multitasking mode.
  39.  
  40.  
  41. REDIRECTION
  42.  
  43. Many *commands peform either input or output. By default the OSCLI command
  44. redirects the output of the command being executed to a RISC OS file before
  45. passing it to the DOS standard output. This allows, for example, piping to the
  46. MORE filter. To prevent this behaviour it is possible to specify the "/S"
  47. switch.
  48.  
  49. Some commands require interactive input and output, such as *Build or *Count.
  50. Specifying the "/I" switch allows use of these commands by attaching both the
  51. input and output of the command to the standard DOS streams. This requires
  52. the command to be frequently suspended to allow input and output to be
  53. processed, so it can appear slightly slower. It may also have problems with
  54. some commands that work without the "/I" switch.
  55.  
  56.  
  57. THINGS TO DO
  58.  
  59. The following are changes that may be made to the OSCLI command sometime in
  60. the future.
  61.  
  62.     Add a switch to run the command in a TaskWindow.
  63.     
  64.     Pre-process VDU sequenced before displaying output.
  65.  
  66.  
  67. VERSION HISTORY
  68.  
  69. 0.00 (12-Nov-95)    Original development version.
  70.  
  71. 0.01 (14-Nov-95)    Added version number and copyright message.
  72.                     Output is passed through the standard output of the DOS
  73.                     command.
  74.  
  75. 0.02 (17-Nov-95)    Uses correct HPC service identifier.
  76.                     Changed to a .COM file to make it smaller.
  77.                     Made redirection of output optional and added help text.
  78.  
  79. 0.04 (16-Dec-95)    Uses real HPC.
  80.  
  81. 1.00 (12-Jan-96)    First official release version.
  82.  
  83. 1.01 (11-Mar-96)    Version number updated to match the module.
  84.  
  85. 1.02 (06-Aug-96)    Added support for Acorn's software PC emulator.
  86.                     Included redirection of input stream through DOS.
  87.  
  88. 1.03 (21-Feb-97)    Unique temporary filenames used.
  89.                     Operation under Window now more reliable.