BRUN            and            CDBRUN

		  written by Ben Hutchings
		and released as version 1.0
		     in September 1994


NOTE: These programs are for OS 2.0 and above, only.


LEGAL

The contents of this package are the files:
    BRun, CDBRun, BRun.doc, BRun.doc.info

These files are all copyright (c) Ben Hutchings 1994, but
they may be freely distributed provided
(i)   no charge is made for them above the costs of
      duplication, distribution and the media used,
(ii)  all the listed files are kept together, and
(iii) the files are unaltered.
The exception to (iii) is that the files may be distributed
in a compressed form as long as the original files can be
retrieved from this form unchanged.

Software released under these conditions is often known as
Freeware.

I reject any responsibility for any undesirable consequences
whatever of the use of this software. This includes, but is
not limited to, secondary consequences, personal injuries or
other kinds of side effects.


INTRODUCTION

BRun is a very simple program which will start any other
CLI program in a totally separate CLI.
BRun works a bit like Run with input/output redirected to
NIL:. Now you may say, why not just do this with a macro:

    Alias BRun Run >NIL: <NIL: [] >NIL: <NIL:

This is what I tried for a while, but unfortunately it
doesn't always work (I can't actually remember what made it
fail, but believe me there was a problem!)

Also, redirecting Run's output to NIL: means that you won't
see any error messages from Run itself, and though it re-
directs standard output it can't stop other programs from
opening '*' and writing to your console window anyway.

BRun simply creates a new and totally separate CLI to run
the one command you give it. It does not generate any output
unless there is an error in creating the new CLI.

CDBRun is also quite simple and will start any other CLI
program in a totally separate CLI with a different current
directory. This is intended for all those programs which
require certain configuration or support files to be in the
current directory when they start. With this command you
don't actually need to change the current directory of the
CLI you are typing into.


INSTALLATION

To install the two commands on your system disk, follow
these instructions (some users will be asked to change disks
at some point):

· Boot from your normal 'Worbench' disk or hard disk.
· Open a Shell/CLI.
· Enter 'Resident C:Copy' (this may cause an error, but that
  doesn't matter).
· Insert the disk this text is on.
· Change the current directory to the directory this text is
  in - you will have to type something like 'CD DF0:BRun'.
· If you have two floppy drives or a hard drive, enter
  'Copy BRun CDBRun C:'.
· If you have only one drive, enter 'Copy BRun CDBRun RAM:',
  then 'Copy RAM:BRun RAM:CDBRun C:',
  then 'Delete RAM:BRun RAM:CDBRun'.
· Enter 'EndCLI' to close the Shell/CLI.


HOW TO USE THE PROGRAMS

To run a program on a new separate CLI, type:

    BRun <command> <arguments>

which is roughly equivalent to

    Run >NIL: <NIL: <command> >NIL: <NIL: <arguments>

but with the differences I explained above!

For CDBRun, the command format is

    CDBRun <directory> <command>

Note that no arguments can be passed to the command by
CDBRun. This is because its own arguments are read in using
the OS function ReadArgs() which separates out the directory
and command name - and also processes all its arguments a
bit. There is no way (that I can see) to extract the
directory name then get the rest of the command line exactly
as it was typed. Sorry!


CONTACT ME

As yet I can only be contacted by Snail-mail.
My address is:

		43 Harrison Close
		Reigate
		Surrey RH2 7HS
		ENGLAND