
This version of BTerp contains implementation of all functions which
will be implemented (a few are not required or relevant under Windows).
You are required to install Codewright version 2.0g or newer to correctly
operate with this version of BTerp.  If you run into a Brief macro which 
won't run or produces an unexpected behavior, we would appreciate it if 
you could specify which macro it is, what it does, or send it to us if it 
is one of your own and we will try to correct the problem.

B-Terp does not read Brief macros files compiled
with the debug option (-d).  You will be notified of such files when
they are loaded by B-Terp.  

To make use of BTerp within Codewright you will have to modify
your cwright.ini file and place cwstart.cm into your BRIEF\MACROS directory.
To modify your cwright.ini file, add the LibPreLoad line below:

	[DefaultKeymap]
	;DefaultKeymap=brief
	LibPreLoad=bterp.dll

You have a couple of options when installing BTerp.  You can use it
in conjunction with Codewright's Brief keymap emulation.  To do so, just
uncomment the "DefaultKeymap=brief" line.  When "bterp.dll" is loaded, it
will detect that the Brief keymap emulation is loaded and not reassign all 
of the Brief macro keys.  Starting at line 33 in cwstart.cb, there are three
functions which initialize Brief's macro key bindings.

		set_default_mouse_action(); // Set the default mouse behavior.
		set_internal_brief_keys();  // Define keys bound internally by brief.
		set_default_brief_keys();   // Define keys bound by Brief startup macros.

These are only called if Codewright's Brief keymap emulation has not been
loaded. 

The only entry point into BTerp is through the function "bterp".  If you
need to call a Brief macro from Codewright, you will need to call it indirectly
through this function.  For example, to call the Brief function "toupper"
from the Codewright "Utility/API COmmand" menu entry, you would enter
"bterp toupper".  

One source of confusion arises when using BTerp is through the assignment 
of <F10>.  There is no noticeable difference between Codewright's Brief 
emulation and BTerp when invoking a macro through the command line except 
for the resulting behavior.  To invoke a Codewright function, <F10> should
be bound to "ExecuteMacro".  To invoke a BTerp function, <F10> should be 
bound to "bterp execute_macro".

Again, thank you for your interest in BTerp.  

		
		Sincerely,
		
		
		
		Eric Johnson
