home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / znode3 / uploads / z3help43.lbr / EXTEND.HZP / EXTEND.HLP
Encoding:
Text File  |  1991-11-10  |  3.8 KB  |  74 lines
  1. ;
  2.                                EXTEND.COM                                    
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5. EXTEND.COM     1k (8)    DE0D  1.4        Bruce Morgen 8/91        Z3COM3
  6. EXTEND.4OM     2k (11)   D4ED  1.4        Bruce Morgen 8/91        Z3COM3
  7.  
  8.   1- Syntax  2- Notes                                                        
  9.  
  10.  
  11.    Text file extender for all Z80 machines.  Appends an input line to a new or
  12. existing ASCII file.  Allows ZCPR named directories.  Great for batch process-
  13. ing under Z-System,  as it can "keep notes" on what happened during unattended 
  14. batch runs.   Works also with CP/M Plus.   Can extend  empty  files as well as
  15. files with no EOF byte in their last record.
  16.  
  17.    Original vs 1.0 (9/81) by Ron Fowler.
  18. :1
  19.     Syntax   EXTEND [dir:]ufn string  - extend "string" plus newline
  20.              EXTEND [dir:]ufn /string - append "string" only
  21.  
  22.    Options   %>      - begin lowercase
  23.              %<      - begin uppercase
  24.              %|      - imbed newline
  25.              %%      - imbed "%"
  26. :2
  27.  EXTEND Notes - 1/3 
  28.  
  29.    a. Vs 1.4 updates (8/14/91, Bruce Morgen):
  30.       - Introduced conditional assembly to produce a reliable Type 4  version.
  31.       - Vastly simplified file I/O code with  SYSLIB  calls  instead of exotic
  32.         FCB evaluation/manipulation.
  33.       - Will no longer work under CP/M 1.x (up to now it probably did!).  
  34.       - Will no longer give up if there is no  EOF in the last record; it will
  35.         just open a new record and proceed.
  36.  
  37.    b. Vs 1.3 updates (1/26/90, Carson Wilson):
  38.       - Fixed for CP/M Plus.   RC byte of FCB can be set to values > 80h under 
  39.         CP/M Plus (high  bit set).   Values > 80h  imply RC = 80h  under  CP/M 
  40.         Plus.
  41.       - Zeroed out (Z3EADR),  which  may have prevented EXTEND from responding 
  42.         to the QUIET patch byte under some non-ZCPR systems.
  43.  Extend Notes - 2/3 
  44.  
  45.    c. Vs 1.2 updates (5/7/89, Carson Wilson):
  46.       - Uses Z80 opcodes.   
  47.       - Uses DSEG for smaller program size.   
  48.       - Senses ZCPR quiet flag and  displays  no informative messages if Quiet 
  49.         flag active.   Patchable byte at [QUIET> reverses sense  of ZCPR quiet 
  50.         flag, showing messages only if Quiet is active.   Under CP/M,  [QUIET> 
  51.         always gives quiet operation if set to a nonzero value.  
  52.       - Program ID included in error messages.   
  53.       - Allows lower case:  "%>" in string  sets to lower case,  "%<" to upper 
  54.         case.  "%c" sends other characters "c" using current case,  "%%" sends 
  55.         a single "%" to file (same as  ZCPR ECHO command).   Patchable byte at 
  56.         [CASE> makes lower case the default if set to 20 hex.   
  57.       - Now uses "%|" to imbed CRLF within a line of input text.
  58.  Extend Notes - 3/3 
  59.  
  60.    d. Vs. 1.1 updates (5/1/87, Bruce Morgen):
  61.       - Accepts "DU:" and "DIR:" form as well as  "D: " under ZCPR3-compatible 
  62.         environments.   This is enabled  by installing  EXTEND  with  Z3INS or 
  63.         Z-RIP,  or automatically by later versions  of the Z3 and BGii command 
  64.         processors.  
  65.       - Skips terminating CR/LF if the appended string begins with a "/".  The
  66.         "/" is discarded.  
  67.       - A "|" in the appended  string is interpreted  as  a  mid-string CR/LF.  
  68.         Aborts on  a line buffer overflow  condition,  which can happen rather 
  69.         easily because of  a combination  the "|"=CR/LF  feature  and the fact 
  70.         that pre-3.3 versions of Z3 command processor do no adequately protect
  71.         the  TPA from encroachment by the command tail.   This situation can't 
  72.         happen under 3.3 or BGii.
  73.         syntax error.
  74.