 CLE - Command Line Editing and Storage Utility   V4      17-Jun-85   -tf-
 ===================================================

 CLE is an interface to the actual CLI, which remembers the last
 commands, so that they can be recalled and edited after an error
 or modified for reuse. It also allows for up to ten commands to be
 stored in a temporary buffer for later use either individually or
 as a group of commands. CLE executes some often used commands with
 one single control-character. Ask your system manager for details.

 CLE can be invoked by >CLE and terminated by <ctrl/Z>. Its prompt
 is either "mce>" with MCR as CLI, "dce>" with DCL as CLI or "cle>"
 for all other CLIs. The buffers are saved in SY:CLECOMTAB.DAT;1 upon
 exit and will be reloaded on restart.

 If your application program does not properly work together with
 CLE run it without CLE !

 Attention: *) denotes nonstandard key encoding of VT100-Keyboard;
               actual code see CLE.MAC


 CLE - Utility Commands
 ----------------------
 
 <ctrl/A>    - Ask for Help-Text
 <ctrl/N>    - No Ready-Beep / Ready-Beep (Toggle)
 <ctrl/]>    - Restart CLE (re-read CLECOMTAB.DAT;1)


 CLE - Cursor Control
 --------------------

 <ctrl/B>    - Go to start (begin) of line
 <ctrl/E>    - Go to end of line

 <tab>                    - Skip one character right
 <rightarrow> or <esc>C   - Skip one character right
 <backspace>              - Go one character left
 <leftarrow>  or <esc>D   - Go one character left


 CLE - Edit Commands
 -------------------

 <character> - Insert this character

 <del>       - Delete one character to the left
 <ctrl/D>    - Delete one character to the right
 <ctrl/K>    - Delete rest of line
 <ctrl/U>    - Delete the left part
 <ctrl/C>    - Clear edit buffer

 <ctrl/W>    - reWrite edit buffer (used on hard copy terminals)



 CLE - FIFO Commands
 -------------------

 <uparrow>        - Take older command from FIFO. shift <PF2>-Pointer
 or <esc>A          (start with first command in FIFO)

 <downarrow>      - Take newer command from FIFO, shift <PF2>-Pointer
 or <esc>B

 <PF1> or <esc>P  - Take oldest command from FIFO, shift <PF2>-Pointer
 <PF2> or <esc>Q  - Take command from FIFO; this Pointer is shifted
                    with <PF1>, <PF3>, <uparrow> and <downarrow>
 <PF3> or <esc>R  - Take newest command from FIFO, shift <PF2>-Pointer

 <PF4> or <esc>S  - Print FIFO


 <ctrl/T>     - First time: Take command from same FIFO-Position.
                Next time: Take older command from FIFO.
                The <ctrl/T>-Pointer is reset with <ctrl/R> or <ctrl/L>


 CLE - Buffer Commands ('new' is the 'edit buffer' you see on the screen)
 ---------------------

 <ctrl/R>         - Retype:  get old command to edit-buffer; Inhibit FIFO
                    Reset <ctrl/T>-Pointer to "old"

 <ctrl/L>         - Take second last command-buffer
                    Reset <ctrl/T>-Pointer to "second last"

 <ctrl/P> n       - Put 'new' to buffer n (if n NOT IN [0..9] : NOP)
                    if edit buffer ist empty, take 'old'.
                    To "clear" a buffer, enter at least one ";" or "!"

 <ctrl/G> n       - Get buffer n to 'new' (if n NOT IN [0..9] : NOP)
 n as first char  - Get buffer n to 'new' ('Function Key')
 <esc> n          - Get buffer n to 'new'

 <ctrl/\>         - Clear all ten buffers

 <ctrl/]>         - Restart CLE (re-read CLECOMTAB.DAT;1)


 CLE - Execute Commands
 ----------------------

 <return>    - Spawn 'new' command to default CLI; Copy 'old' to
               'second last' and 'new' to 'old' (FIFO); Clear 'new'.

 <ctrl/X> mn - Spawn buffers m to n to default CLI; make FIFO.
               (if m,n NOT IN [0..9] : NOP)

 <esc><esc>  - Spawn 'new' command to MCR; Copy 'old' to 'second last'
               and 'new' to 'old' (FIFO); Clear 'new'.

 <lf>        - Spawn 'new' command to DCL; Copy 'old' to 'second last'
 or <ctrl/J>   and 'new' to 'old' (FIFO); Clear 'new'.
               ( To use this command, DCL must be installed (again)
               as a multi user task  >INS $DCL/TASK=...DCM )


 CLE - Fixed Commands (can be edited in CLE.MAC)
 --------------------

 <ctrl/V>              - Execute 'VITE'-Command
 <ctrl/Y>              - Purge all files

 <ctrl/`> or <ctrl/~> *) <ctrl/^>  - Toggle CLI ( DCL / MCR )
 <ctrl/?> or <ctrl//> *) <ctrl/_>  - sorted Directory

 BLANK as first char   - MCR


 CLE - Terminating Commands
 --------------------------

 <ctrl/Z>      - Store Buffers in SY:CLECOMTAB.DAT;1 and exit
 <ctrl/F>      - Finish; Exit without File-Output

 BYE           - Store Buffers in SY:CLECOMTAB.DAT;1 and Log out
 LO (DCL only) - Store Buffers in SY:CLECOMTAB.DAT;1 and Log out


 Special characters
 ------------------

 <ctrl/O>    - ignored
 <ctrl/Q>    - Resume Output
 <ctrl/S>    - Stop Output






      CLE-Buffers, saved in SY:[defaultuic]CLECOMTAB.DAT;1
      ====================================================

      "default uic" is the uic where you started CLE


      !-----------------------------------------------------------------!
  0:  !									!
  .   !									!
  .   !   Temporary Command-Buffers 0..9                                !
  .   !									!
  9:  !									!
      !-----------------------------------------------------------------!
                     ^                     !                    !
                     !      (first char) n !                    !
                     !             <esc> n !      Exec  ^X mn   !
        Put    ^P n  !      Get       ^G n !      (from to)     !
                     !                     !                    !
                     !                     v                    v
      !-----------------------------------------------------------------!
  new !   Edit-Buffer,  spawned to actual CLI  with <return>            !
      !-----------------------------------------------------------------!
                     ^    ^            ^                        !
        Retype  ^R   !    !            !              <return>  !  (CLI)
                     !    !   !----------------!    <esc><esc>  !  (MCR)
                     !    !   ! fixed commands !          <lf>  !  (DCL)
                     !    !   !----------------!                !
                     !    !                                     v
      !-------------------!---------------------------------------------!
  old !                   ! newest command in FIFO                      !
      !- - - - - - - - - -!- - - - - - - - - - - - - - - - - - - - - - -!
                          !                                     !
        Second last ^L    !                             (FIFO)  !
                          !                                     !
        FIFO oldest <PF1> ! FIFO older <uparrow> or ^T          !
        FIFO fixed  <PF2> !                                     !
        FIFO newest <PF3> ! FIFO newer <downarrow>              !
                          !                                     v
      !- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -!
  last!                    Second last spawned command                  !
      !- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -!
      ! newer                                                   !       !
      !                        FIFO (variable length)           !       !
      ! older                                                   !       !
      !                                                         !       !
      ! oldest command in FIFO                                  !       !
      !---------------------------------------------------------!-------!
                                                                v






 INSTALLATION
 ------------

  First:

  - define your 'fixed commands' in CLE.MAC
    and update this help file CLE.HLP

  - if you don't have CLI support (or RSX V3.2)
    change the symbol CLISUP in CLE.MAC to -1


  MCR-Commands:
  ------------
  >
  >MAC CLE=CLE
  >TKB CLE/CP=CLE            (ev. with FCSRES)
  >PIP CLE.OBJ;*/DE
  >
  >PIP all:[*,*]CLECOMTAB.DAT;*/DE
  >PIP LB:[1,2]CLE.HLP=CLE.HLP
  >INS CLE/TASK=...CLE
  >INS $DCL/TASK=...DCM    ! for <lf> command, comment see CLE.MAC
  >

  DCL-Commands
  ------------
  >
  >MAC CLE
  >LINK/CHECK/OPT CLE
   Options? LIBR=FCSRES:RO
   Options?
  >
  >DEL CLE.OBJ;*
  >
  >DEL all:[*,*]CLECOMTAB.DAT;*
  >COP CLE.HLP LB:[1,2]CLE.HLP
  >INS CLE/TASK=...CLE
  >INS $DCL/TASK=...DCM    ! for <lf> command, comment see CLE.MAC
  >

  use CLE:
  -------
  >
  >CLE
  cle>
  .
  .
  cle>^Z
  >

  to start CLE in LOGIN.CMD use the command
  .XQT CLE


