;
                                ZERRLSH.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
ZERRLSH.COM    4k (29)   16A4  1.3a       Rob Friefeld 10/89       Z3COM13
ZERRINST.COM   4k (29)   F8E7  1.3a       Rob Friefeld 10/89       Z3COM13

  1- Syntax/Options  2- Installation  3- Notes                                


   ZERRLSH is  a ZCPR 3.3+ error handler  which performs  all the functions of
ZERR 1.1.  If the LSH history shell is active, ZERRLSH performs the additional
function of automatically  updating the history file when  an error generating 
command line is edited.

   ZERRINST.COM is the installation program for ZERRLSH.COM.
:1

   Syntax     ZERRLSH          -->   Install program as current error handler
              ZERRLSH o        

              o = /            -->   Show ID message
              o = <any other>  -->   Remove error handler

   Display   

Cmdline Error:
 Command not found (even by ECP)

[ESC - Abort / TAB - Skip]

DU:NAME>badcmd1;badcmd2
:2
 Installation 

     The installation program  facilitates customizing the command set to your
preference.  There are also two special items.

     1)  LSH's current name.   In order to  determine that LSH is  the current
shell, ZERRLSH needs a specific name to look  for.   If you have changed LSH's 
name, you will have to install the new name.

     2)  Records to read.   LSH reads  a maximum  number of  records  from the 
history file.   Ideally,  the error handler should read the same number.   The 
default  value  is  40 records  =  5k.   (Future  versions  will  handle  this 
automatically.)
:3
 ZERRLSH Notes - 1/2 

   a. If LSH  is the current shell,  its history file  spec  is taken from the 
      shell stack,  the file is opened, and  a backward search is made  for  a 
      match to the error generating command line.   The line  may not be found 
      if LSH's SAVE is  toggled off or  if the error is generated by an alias.  
      If there  are  multiple occurrences  of the  line,  only the last one is 
      updated.

   b. Vs 1.2 updates:
      - reads as much of the  history file as  does LSH 1.0n,  no installation
        needed
      - eliminates a space added to  the  end  of some command lines  by ARUNZ 
        which meant they couldn't  be matched in the history file.   Note that
        if you write the history file in lower case, a bad command will appear
        in lower case when it has been found in the history file.   Otherwise,
        it will be in upper case. 
 ZERRLSH Notes - 2/2 

   c. Vs 1.0a updates:
      - "[ESC - Abort ...]" line was  moved  flush  with  the left side of the 
        screen. 
      - "[Error] DU:NAME>" prompt was  minimized by  eliminating the "[Error]" 
        part  (you don't need that part of  the prompt when  the Error handler 
        has already told you that there is an error and  also telling you what
        type of error it is!).
      - "Command Line Error: ... " line was  shortened to "Cmdline Error:" and 
        the type of error placed on the next line.