README.md
CLE is an interactive command line editor for RSX. This is a non-privileged
task which requires no modification whatsoever to any other software. It works
with MCR, DCL, and CCL. With CLE the user is able to edit his command line
before or even after dispatching the CLI and it "remembers" the last several
commands which can be recalled, edited, and resubmitted as well. It is very
"VMS-like" though the user can toggle between "VMS mode" and "CLE mode",
changing the definitions of several <Ctrl> keys (others do not change). CLE
function keys and <Ctrl> keys are described below.

CLE function keys & <Ctrl> keys

LEFTARROW backup 1 character UPARROW backup 1 command
RIGHTARROW advance 1 character DOWNARROW advance 1 command
GOLD_LEFT backup to begin of cmd GOLD_UP backup to oldest cmd
GOLD_RIGHT advance to end of command GOLD_DOWN advance to newest cmd
^A overstrike/insert
DELETE delete 1 character left PF1 GOLD
^D delete 1 char at cursor PF2 help
^B delete to begin of cmd PF3 show status
^E delete to end of command PF4 show all commands
^R redisplay command ^K CLE/VMS <Ctrl> keys
^U cancel command ^Z exit CLE

VMS <Ctrl> keys

^D backup 1 character ^B backup 1 command
^F advance 1 character
^H backup to begin of cmd
^E advance to end of command
^A overstrike/insert
^R redisplay command ^K CLE/VMS <Ctrl> keys
^U delete to begin of cmd ^Z exit CLE

There are three options determined by assembly conditionals. If the symbol
LINE24 is defined, line 24 is is used as a status line (requires VT100/VT220
and only partially tested). OVRMOD determines whether insert mode or overstrike
mode is the default, and VMSKEY determines whether CLE <Ctrl> keys or VMS <Ctrl>
keys is the default.

You should be aware of the following problems/unexpected behaviors:

1. If a character is inserted or deleted to the left of a horizontal tab
("011) or if a tab is inserted to the left of any character, the command
line will be displayed improperly, though passed to the CLI correctly.
<CTRL-R> can be used to redisplay the command line.
2. CLE must wait for completion. So pressing <RETURN> while a command is
executing will generate a CLI prompt, not a CLE prompt. And the command
entered at the CLI prompt can not be edited.
3. CONTROL-C ABORT, under versions of RSX which support it, should be disabled
for CLE use.
4. Some kind of problem exists between CLE and SET /UIC with named directory
support. Not fully investigated.

Included in this distribution are the following files:

CLE.HLP help file, move to LB:[1,2]
CLE.MAC source file
CLE.MAK command file to assemble & taskbuild
MYMACS.MLB library containing macros such as PUSH, POP, JEQ, etc.
README.1ST this file

CLE can be installed and then invoked by typing "CLE" or you might consider
placing ".xqt CLE" in your LOGIN.CMD.