readme.demo		Kerry Zimmerman [71470,1340]		April 15, 1989
				4427 Rosada Street
				Long Beach, Ca 90815


This archive contains the following files:

	readme.demo		This file
	config!r		Very modified version of the Uedit AREXX interface
    REXXCOMM		Sample AREXX to Uedit commands database
    demofile		A file used by the AREXX demo
	demo.urexx		A demonstration of the new AREXX/Uedit interface


The purpose of the archive is to introduce a new Uedit interface for
AREXX.  The original interface was cryptic, non-intuitive and somewhat
difficult to use.  In addition, it made AREXX interface programs for
Uedit difficult to read, which is bad because one of the nice parts of
the AREXX language is its English-like structure.

The new interface uses a data file called REXXCOMM, that associates
a command name to a series of MacroNums and InputChars.  This allows
the command names to be used in Uedit's AREXX programs.

REXXCOMM is just an ascii file that can be edited with Uedit.  However,
since it is a bother to have to look up the MacroNums, a utility has been
built into Uedit to make adding new commands easy.  The utility is invoked
by "altctl-0" (thats alt control ZER0).  It first asks for a command name.
Enter the string you want followed by pmESC.  Next, the utility waits
for you to enter the keystrokes to be associated with the command string.
End the list with another pmESC.  Finally, save the file (f2 or f3).

Using the commands from AREXX is easy.  
(Be sure Uedit's autotraffic mode is ON by using altctl-9.)  
Simple one-liners are possible from a CLI.   For example: 		
			rx u loadfile 'myfile'
tells uedit to load the file, "myfile".

More interesting things can be done from a full AREXX script.
Begin the script by telling AREXX you want commands to be sent to Uedit
by using: 

		address 'URexx'

Next, tell AREXX you want Uedit to send back result strings by

		options results

Now you can create a script that contains the commands you created in
the REXXCOMM database.  Anytime a response is supposed to be returned
from the command, it will be in the AREXX variable, 'result'.

For example, a command called 'ask' will put up a yes/no requestor
and return 'YES' or 'NO' in the result variable.  

The file demo.urexx demonstrates the usage of this new AREXX interface.
Put REXXCOMM, demo.urexx and demofile in a directory.  Start uedit and
compile the new config!r.  Now turn on autotraffic mode with alt-ctl-9.
Let's start the demo from with Uedit.  To do this, use alt-ctl-1 to edit
the AREXX output buffer.  Clear any old contents and enter "demo".
Now lets start the demonstration by sending the output buffer with
alt-ctl-3.  (Be sure you have started the rxmaster program so the 
resident Arexx program is running).

You will see some cursor movements and some lines deleted and inserted
at your request.  Examine the demo.urexx file to see how this was
created.