home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 3 / goldfish_volume_3.bin / files / util / cli / brun / brun.doc < prev    next >
Encoding:
Text File  |  1994-10-15  |  3.7 KB  |  122 lines
  1.  
  2.         BRUN            and            CDBRUN
  3.  
  4.           written by Ben Hutchings
  5.         and released as version 1.0
  6.              in September 1994
  7.  
  8.  
  9. NOTE: These programs are for OS 2.0 and above, only.
  10.  
  11.  
  12. LEGAL
  13.  
  14. The contents of this package are the files:
  15.     BRun, CDBRun, BRun.doc, BRun.doc.info
  16.  
  17. These files are all copyright (c) Ben Hutchings 1994, but
  18. they may be freely distributed provided
  19. (i)   no charge is made for them above the costs of
  20.       duplication, distribution and the media used,
  21. (ii)  all the listed files are kept together, and
  22. (iii) the files are unaltered.
  23. The exception to (iii) is that the files may be distributed
  24. in a compressed form as long as the original files can be
  25. retrieved from this form unchanged.
  26.  
  27. Software released under these conditions is often known as
  28. Freeware.
  29.  
  30. I reject any responsibility for any undesirable consequences
  31. whatever of the use of this software. This includes, but is
  32. not limited to, secondary consequences, personal injuries or
  33. other kinds of side effects.
  34.  
  35.  
  36. INTRODUCTION
  37.  
  38. BRun is a very simple program which will start any other
  39. CLI program in a totally separate CLI.
  40. BRun works a bit like Run with input/output redirected to
  41. NIL:. Now you may say, why not just do this with a macro:
  42.  
  43.     Alias BRun Run >NIL: <NIL: [] >NIL: <NIL:
  44.  
  45. This is what I tried for a while, but unfortunately it
  46. doesn't always work (I can't actually remember what made it
  47. fail, but believe me there was a problem!)
  48.  
  49. Also, redirecting Run's output to NIL: means that you won't
  50. see any error messages from Run itself, and though it re-
  51. directs standard output it can't stop other programs from
  52. opening '*' and writing to your console window anyway.
  53.  
  54. BRun simply creates a new and totally separate CLI to run
  55. the one command you give it. It does not generate any output
  56. unless there is an error in creating the new CLI.
  57.  
  58. CDBRun is also quite simple and will start any other CLI
  59. program in a totally separate CLI with a different current
  60. directory. This is intended for all those programs which
  61. require certain configuration or support files to be in the
  62. current directory when they start. With this command you
  63. don't actually need to change the current directory of the
  64. CLI you are typing into.
  65.  
  66.  
  67. INSTALLATION
  68.  
  69. To install the two commands on your system disk, follow
  70. these instructions (some users will be asked to change disks
  71. at some point):
  72.  
  73. · Boot from your normal 'Worbench' disk or hard disk.
  74. · Open a Shell/CLI.
  75. · Enter 'Resident C:Copy' (this may cause an error, but that
  76.   doesn't matter).
  77. · Insert the disk this text is on.
  78. · Change the current directory to the directory this text is
  79.   in - you will have to type something like 'CD DF0:BRun'.
  80. · If you have two floppy drives or a hard drive, enter
  81.   'Copy BRun CDBRun C:'.
  82. · If you have only one drive, enter 'Copy BRun CDBRun RAM:',
  83.   then 'Copy RAM:BRun RAM:CDBRun C:',
  84.   then 'Delete RAM:BRun RAM:CDBRun'.
  85. · Enter 'EndCLI' to close the Shell/CLI.
  86.  
  87.  
  88. HOW TO USE THE PROGRAMS
  89.  
  90. To run a program on a new separate CLI, type:
  91.  
  92.     BRun <command> <arguments>
  93.  
  94. which is roughly equivalent to
  95.  
  96.     Run >NIL: <NIL: <command> >NIL: <NIL: <arguments>
  97.  
  98. but with the differences I explained above!
  99.  
  100. For CDBRun, the command format is
  101.  
  102.     CDBRun <directory> <command>
  103.  
  104. Note that no arguments can be passed to the command by
  105. CDBRun. This is because its own arguments are read in using
  106. the OS function ReadArgs() which separates out the directory
  107. and command name - and also processes all its arguments a
  108. bit. There is no way (that I can see) to extract the
  109. directory name then get the rest of the command line exactly
  110. as it was typed. Sorry!
  111.  
  112.  
  113. CONTACT ME
  114.  
  115. As yet I can only be contacted by Snail-mail.
  116. My address is:
  117.  
  118.         43 Harrison Close
  119.         Reigate
  120.         Surrey RH2 7HS
  121.         ENGLAND
  122.