_______________________________________________________________________

RUN! v0.80 - (C)Copyright 2003-2009  RL Walsh  All Rights Reserved
_______________________________________________________________________

RUN! can eliminate scripts and config.sys entries needed to start
many programs - particularly those started as 'helper-apps' by other
programs.  It sets the current drive, directory, and BeginLibPath to
the directory containing the .exe, sets any options you've chosen,
then starts the program.

EXAMPLE
To start d:\apps\net\xyz.exe without a script or config.sys entries,
using your secondary codepage and LIBPATHSTRICT:

 - copy run!.exe to xyz's directory
 - rename it xyz!2l.exe
 - update programs & objects to start d:\apps\net\xyz!2l.exe

OPTIONS
Insert these options between the '!' and the '.exe'.  They are not
case-sensitive and can be entered in any order. (* = new in v0.80)

General:
  L  - set LIBPATHSTRICT (use option 'U' to turn it off)

  E  - modify environment using file 'exename!.ENV' (e.g. xyz!.env)

  K  - keep Run! in memory until the program ends so that WPS icons
       show they're in use - requires an extra 600k of memory

  Z  - set priority:  use 'Z' by itself set the priority to 400,
       or use 'Zcdd' to specify the priority [c= 1-4  d= 00-31]

 1|2 - use the primary|secondary codepage

  B  - enable BiDi language support, if available

  M  - start VIO programs minimized

  N  - don't close VIO windows on exit

  Q  - quiet operation:  no beeps or error messages

  R  - show messages for non-fatal errors ('Q' overrides this)

  C  - use if command-line parameters aren't passed to the program

* -x - use a minus sign to turn off an option set elsewhere -
       see the examples in "Environment Variables" for details

Redirect stdout and/or stderr:
* G - to file 'exename!.log' (e.g. 'xyz!.log')

* S - to the screen - requires 'tee.exe'

* T - to both screen & file - requires 'tee.exe' or a substitute

  Use G1|S1|T1 to redirect stdout only, or G2|S2|T2 for stderr only.
  See "Environment Variables" to rename the log file or replace 'tee.exe'.

Session Type:
  P - PM    V - VIO window    F - Full screen    D - Default
  overrides the default type for this program (if possible)

Send comments & bug reports to:  Rich Walsh <rich@e-vertise.com>

_______________________________________________________________________

ENVIRONMENT VARIABLES
_______________________________________________________________________


 - SET RUN!OPTS=
   Use in an environment file (i.e. 'xyz!.env') to add, override, or
   disable options set in the filename.

   Example:  for 'xyz!SZE.exe'
     SET RUN!OPTS=K   adds the 'keep' option
     SET RUN!OPTS=G   overrides 'S' and sends stdout to a log file
     SET RUN!OPTS=-Z  disables the 'set priority' option (note
                      the minus sign before the existing option)
     SET RUN!OPTS=-E  ignore all environment settings in the '!.ENV'
                      file except for SET RUN!OPTS=

 - SET RUN!LOG=
   Overrides the default name & location of the log file created by
   the 'G' & 'T' options (i.e. 'exename!.log' in the exe's directory).
   To have Run! insert the exe's name, include 'RUN!' in uppercase
   letters in the name.  If nothing follows 'RUN!', it will add
   '!.LOG' as an extension.

   Example:  for 'xyz!TE.exe'
     SET RUN!LOG=f:\temp\RUN!         ->  f:\temp\XYZ!.LOG
     SET RUN!LOG=%LOGFILES%\RUN!.out  ->  c:\var\log\XYZ.out

 - SET RUN!TEE=
   For option 'T' only, specifies the program Run! should use instead
   of 'tee.exe'.  Provide the program's complete filename (i.e. enter
   'myfilter.exe', not just 'myfilter') along with any command line
   arguments it requires.  If Run! finds the letters 'RUN!' in the
   command line, it will replace them with the primary program's name.

   Example:  for 'xyz!TE.exe'
     SET RUN!TEE=myfilter.exe /asdf filter.txt
     SET RUN!TEE="f:\path with spaces\tee.exe" -a RUN!.out

_______________________________________________________________________

MISCELLANEA
_______________________________________________________________________


 - When you execute run!.exe without renaming it, RUN! will display
   a condensed version of the Example and Options info shown above.

 - If program xyz.exe doesn't need any options, you can also rename
   run!.exe as !xyz.exe.

 - You can add, delete, or modify any environment variable using
   an environment file.  Entries should be in the standard format,
   i.e. SET KEY=VARIABLE, and can include substitution variables,
   e.g. %PATH%.  Blank lines and lines starting with 'REM' will be
   ignored;  anything else will generate a non-fatal error message.

   You can also set BEGINLIBPATH and ENDLIBPATH from the environment
   file (even though they aren't true environment variables).  Do NOT
   include the directory containing the .exe - RUN! always adds this
   directory automatically.

 - Suggestion:  after you copy & rename RUN!, open its WPS notebook
   to the Icon page, then drop the original exe on the current icon.
   This will give the file and any program objects the correct icon.

 - The 'V' option may be useful with PM programs that are known to
   support a console window for displaying error or debugging messages
   (e.g. Mozilla apps).

 - When using options 'S' & 'T', text written to stdout may not appear
   on the screen immediately due to buffering by the program's C
   library.  Text written to stderr will usually appear immediately.
   If the program supports it, you may want to use option 'V' instead.

 - RUN! will beep and display a message if it detects a fatal error
   while preparing to start a program.  It will display additional
   messages for non-fatal errors if you include the 'R' option. Use
   the 'Q' option to disable the beep and all messages.

 - RUN! was designed to eliminate the need to add directories to
   your PATH.  It is usually started using the renamed file's full
   drive and directory specification (e.g. d:\apps\net\xyz!.exe).
   However, if it happens to be in a directory that is already
   included in the PATH, you can use just its name (e.g. xyz!.exe).

_______________________________________________________________________

LICENSE
_______________________________________________________________________


RUN! v0.80 is licensed to you without charge.  You may copy and freely
redistribute it to others, and may package it with both noncommercial
and commercial software products provided you include a copy of this
License and the Copyright notice above.

This program is provided on an as-is basis.  It is not warranted to
be free of defects nor to be suitable for any particular purpose the
licensee may put it to. The licensee agrees to use it at his or her
own risk, and agrees to accept all liabilities arising from its use,
including all claims by third parties, without recourse to the author
or copyright holder.

THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, OF ANY SORT. BY YOUR
USE OF THE PROGRAM YOU AGREE TO THE TERMS OF THIS LICENSE.   

Future versions of RUN!, if any, may be released under a different
license with different terms and conditions.

_______________________________________________________________________

Rich Walsh  <rich@e-vertise.com>
Ft Myers, FL

June 2, 2009
_______________________________________________________________________

