bP Macro 2.0 - Copyright (C) 1997, 1998 Jem E. Berkes

Web:    http://www.alkaid.ml.org/
FTP:    ftp://ftp.alkaid.ml.org/pub/
E-mail: berkes@altavista.net

This software is shareware.  You may distribute it through any means (WWW,
FTP, NNTP, BBS, disk) provided that it remains unmodified and that you charge
no fee for distribution with the exception of reasonable media charges.


New features in bP Macro version 2.0:

- Hotkeys can include ALT, SHIFT or CTRL+key combinations.
- It is much easier to define a macro.
- There can be up to 255 keys in a macro.
- The macro can be uninstalled from memory.

bP Macro is a one-of-a-kind DOS utility. It will let you easily define macros
which you can "play" from practically ANY program.  So it will work from the
DOS prompt as well as from application programs such as Quicken, Word Perfect
and AutoCAD to name a few.  bP Macro lets you define any key/combination as a
"hotkey" which initiates a series of up to 255 recorded keystrokes.  So for
example you can define a macro which automatically logs into your workstation
when you press a hotkey, such as [ALT]+[L].

THIS IS THE SHAREWARE VERSION OF BP MACRO.  IT IS, HOWEVER, FULLY FUNCTIONAL.
SO WHY REGISTER IT?

   THE REGISTERED VERSION HAS AN EXTRA FEATURE: IT WILL LET YOU RECORD MACROS
   AND SAVE THEM TO FILES, SO YOU CAN QUICKLY LOAD THEM (INSTEAD OF DEFINING
   THE MACRO EACH TIME YOU RUN BPMACRO).  IF YOU FIND YOURSELF USING BPMACRO
   VERY OFTEN WITH THE SAME MACRO, YOU WILL FIND THE ABILITY TO RECORD YOUR
   MACROS AND AUTOMATICALLY LOAD THEM (WHEN BOOTING UP, FOR EXAMPLE) VERY
   USEFUL.

Before sending a payment, please e-mail me at <berkes@altavista.net> in order
to confirm software availability (the registered software will also be sent
to you through e-mail).  You can then register bP Macro and get the advanced
version (Macro Pro and Macro Recorder) by mailing a cheque for $28 US (or $40
Canadian), along with your e-mail address to:

Jem E. Berkes
185 Waverley Street
Winnipeg, Manitoba
R3M 3K4
Canada

If you would like a site license (for a commercial or multiuser environment),
please contact Jem Berkes <berkes@altavista.net>.

If you would like a "Registered to [?]" message to appear, please include a
name (or company title) to appear in the message.


1       SYSTEM REQUIREMENTS

  You must have an enhanced keyboard and appropriate BIOS (Basic Input/Output
system).  If you have an IBM PC or 100% compatible system which is dated any
time after 1982, bP Macro should work OK.


2       INSTALLING AND USING

  With the shareware version of bP Macro, you must "define" the macro each
and every time you run bP Macro (if you register, you will get an advanced
version of the software which can also load a user-defined macro).

To install a macro with the shareware version, all you have to do is type
BPMACRO at the DOS prompt.  Then follow these steps:

a) Define the hotkey. This keystroke will be used to initiate the macro. You
   can use nearly any key on the keyboard, or ALT/SHIFT/CTRL+ a key. Examples
   of valid hotkeys are [F11], [SHIFT]+[Esc], and [CTRL]+[F12].

b) Type in each keystroke in the macro EXACTLY as you would in the target
   application.  No complex code syntax is necessary. Whatever you type in is
   what bP Macro will run as the macro.

c) Enter the hotkey once more to signal the end of the macro.

bP Macro will then install itself into memory, occupying 432 to 944 bytes of
memory, depending on the size of the macro.  When the hotkey is detected, the
keystrokes you entered earlier will be "typed out".  Note that you have to
release the hotkey before the macro is executed.

You can install as many macros as you want.


3       UNINSTALLING THE MACRO

  bP Macro can be uninstalled from memory as long as no other memory resident 
programs (TSRs) have been loaded since bP Macro.  To uninstall bP Macro (or
to uninstall the most recently loaded macro when there is more than one in
memory), type: BPMACRO /U


4       BP MACRO ERROR CODES (ERRORLEVELS)

  For those people who are willing to tinker a bit with DOS, errorlevels are
a valuable tool. By reading these values returned from programs, batch files
(simple programs which run a "batch" of commands) can automatically detect
the result of a command and take appropriate action if an error ocurred. 

bP Macro always returns one of the following "errorlevels":

ERRORLEVELs:

0 = Success: bP Macro loaded as a TSR
1 = Command-line syntax error
2 = Macro overflow: maximum 255 keystrokes
3 = TSR could not be removed
4 = Uninstall successful
