;
                               EXTEND.COM                                    

             Size (recs) CRC   Version    Author/Latest Issue      Disk
EXTEND.COM     1k (8)    B1B2  1.3        Carson Wilson 1/90       Z3COM3
EXTEND.4OM     2k (11)   2774  1.3        Carson Wilson 1/90       Z3COM3

  1- Syntax  2- Notes                                                        


   Text file extender for all Z80 machines.  Appends an input line to a new or
existing ASCII file.  Allows ZCPR named directories.  Great for batch process-
ing under Z-System,  as it can "keep notes" on what happened during unattended 
batch runs.  Works also with CP/M Plus.  Original vs 1.0 (9/81) by Ron Fowler.
:1


    Syntax   EXTEND <filename> <string>

   ...which appends <string> to end of file <filename>

   'EXTEND //' will display a brief help message.
:2
 EXTEND Notes - 1/2 

   a. Vs. 1.3 updates (1//26/90):
      - Fixed for CP/M Plus.   RC byte of FCB can be set to values > 80h under 
        CP/M Plus (high  bit set).   Values > 80h  imply RC = 80h  under  CP/M 
        Plus.
      - Zeroed out (Z3EADR),  which  may have prevented EXTEND from responding 
        to the QUIET patch byte under some non-ZCPR systems.

   b. Vs. 1.2 updates:
      - Uses Z80 opcodes.   
      - Uses DSEG for smaller program size.   
      - Senses ZCPR quiet flag and  displays  no informative messages if Quiet 
        flag active.   Patchable byte at [QUIET> reverses sense  of ZCPR quiet 
        flag, showing messages only if Quiet is active.   Under CP/M,  [QUIET> 
        always gives quiet operation if set to a nonzero value.  
      - Program ID included in error messages.   
 EXTEND Notes - 2/2 

      - Allows lower case:  "%>" in string  sets to lower case,  "%<" to upper 
        case.  "%c" sends other characters "c" using current case,  "%%" sends 
        a single "%" to file (same as  ZCPR ECHO command).   Patchable byte at 
        [CASE> makes lower case the default if set to 20 hex.   
      - Now uses "%|" to imbed CRLF within a line of input text.

   b. Vs. 1.1 updates:
      - Accepts "DU:" and "DIR:" form as well as  "D: " under ZCPR3-compatible 
        environments.   This is enabled  by installing  EXTEND  with  Z3INS or 
        Z-RIP,  or automatically by later versions  of the Z3 and BGii command 
        processors.  
      - Skips terminating CR/LF if the appended string begins with a "/".  The
        "/" is discarded.  
      - A "|" in the appended  string is interpreted  as  a  mid-string CR/LF.  
        Aborts on  a line buffer overflow  condition,  which can happen rather 
        easily because of  a combination  the "|"=CR/LF  feature  and the fact 
        that pre-3.3 versions of Z3 command processor do no adequately protect
        the  TPA from encroachment by the command tail.   This situation can't 
        happen under 3.3 or BGii.
        syntax error.