;
 (Z34 resident program)            CLED                                       

             Size (recs) CRC   Version    Author/Latest Issue      Disk
              n/a (n/a)  n/a   1.5        Rob Friefeld 7/91        Z3COM3
CLEDINST.COM   6k (41)   E66A  1.5        Rob Friefeld 7/91        Z3COM3
CLEDSAVE.COM   1k (8)    5310  1.5        Rob Friefeld 7/91        Z3COM3

  1- Syntax  2- Installation  3- History Save/Load Tool  4- Notes             


   CLED is  a memory resident command line editor  which  extends  the minimal
features of the CCP  to include  cursor movement,  insert/delete,  and record/
recall of command lines.   Though part of the RCP, CLED is also a ZCPR "shell"
which automatically reinvokes itself following any ZCPR command.  It thus uses
up one shell stack entry (normally,  there are four,  which is plenty).   If a 
ZS/ZDDOS,  DateStamper,  or Z3PLUS  clock is  implemented,  the command prompt 
shows the system time.   To  disable time display under Z3PLUS (if you have no
clock) set the system date to 01/01/78.
:1

   Syntax   CLED
            CLED [/]
             If "/", run once only (e.g. from a shell such as ZFILER)

   The default control key set includes these important commands:

      CR - execute command line
   ESC Q - pop the shell
   ESC S - toggle recording on/off  (prompt shows >/>> to indicate state)
      ^W - recall command lines from history stack
      ^E - recall history in reverse direction
:2
 Installation 

   The installation program, CLEDINST, allows you to set up the editor to your
preference.  The RCP can be installed directly in memory for testing, and then
saved to a file with SNAP or NZBLITZ.  A SNAP or  NZBLITZ system configuration
file can also be installed directly,  as can a RCPxxx.ZRL file IF it is assem-
bled in SLR format.  (MREL format files are bit-shifted and cannot be install-
ed.)   CLEDINST also serves  as  a  "Help"  utility by  displaying the current
command bindings.  Type "CLEDINST //" for help with CLEDINST.COM.
:3
 History Save/Load Tool 

   CLEDSAVE writes the contents of the  history stack to  a text file on disk.  
The file can  be  reloaded  later (CLEDSAVE <file> L),  or composed in advance 
with  a text editor,  then loaded.   If the file is  too large for the history
stack, as many commands as fit are loaded.

   CLEDSAVE is useful as in  a startup alias  to load  frequently used command
lines from an easily altered file.  For example, alias START:

A15:
CLEDSYS              <-- load SNAP image of ENV,TCAP,RCP,FCP,NDR,QUIET, & PATH
CLEDSAVE CLED.VAR L  <-- load precomposed command lines into CLED
CLED                 <-- turn the shell on
...                  <-- rest of startup line runs before CLED gets control

   For help with CLEDSAVE.COM, type "CLEDSAVE //".

   You may also use  SNAP or  NZBLITZ to  save the  system  segment image with
command lines already loaded (turn SAVE OFF first).
:4
 CLED Notes 

   a. Vs 1.5 updates (7/5/91, Rob Friefeld):
      - Simplified many routines for shorter code size.
      - Echos CR immediately.
      - Explicitly checks for comment line.
      - Shell bit reset on entry for AT compatibility.
      - New command:  Kill to next command.
      - Backspace destructive/non-destructive installable.
      - Alternate registers need not be preserved by BIOS on CIN call.
