home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / c.lbr / CPA.HZP / CPA.HLP
Encoding:
Text File  |  1991-11-18  |  5.0 KB  |  98 lines
  1. ;
  2.                                     CPA.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                4k (32)   49B4  1.3        Bruce Morgen 7/91        Z3COM2
  6.  
  7.   1- Syntax  2- Usage  3- Notes                                               
  8.  
  9.  
  10.    ComPare Ascii utility will analyze two text files, on a line by line basis,
  11. reporting any  differences via a  split  screen  with a  window for each file.
  12. Files may be scrolled separately,  allowing  realignment after the first  mis-
  13. match.   If available,  video  highlighting  shows  differences between files.
  14. Under ZSDOS or Z3PLUS, file datestamps are also displayed.
  15.  
  16.    For purposes of  this  utility,  lines are terminated by a  <CR><LF>  pair.
  17. Also,  before comparison,  all tab  characters are expanded.   Lines of length
  18. longer than a screen width will wrap,  causing  following of the lines in BOTH
  19. windows to scroll down.  Version 1.0 by Malcom Kemp (1/87).
  20. :1
  21.     Syntax   CPA [dir:]ufn [dir:][ufn]
  22.  
  23.    ... where the file specification  must  be  unambiguous,  but otherwise any
  24. allowable Z-system specification.   If a file is missing,  or a line exceeding
  25. 1015 characters is found in a file, CPA exits to the operating system with the
  26. appropriate error message.
  27.  
  28.  
  29.   Commands while CPA is active 
  30.  
  31.           X, ^X  - Scroll the current screen up
  32.           E, ^E  - Scroll the current screen down
  33.         <sp>, S  - Switch screens
  34.               G  - Go on comparing at the next pair of lines  
  35.              ^C  - Abort to operating system
  36. :2
  37.  Usage - 1/2 
  38.  
  39.    The compare will proceed until a mismatch occurs or until the end of one or 
  40. both files is reached,  whichever comes first.   At this time,  the names  and 
  41. current lines, and file datestamps if available, are displayed.  If a mismatch
  42. is found, the  mismatched line will be shown as the last line in each display.
  43. The user can then manipulate the lines in  each screen to achieve synchroniza-
  44. tion,  and begin the compare again.  The compare  will continue from  the line 
  45. AFTER the displayed line forward.
  46.  
  47.    If your terminal supports video attributes,  the display will highlight the
  48. text in each window beyond the point of mismatch.  Under ZSDOS or Z3PLUS, file
  49. datestamps are  displayed  along  with each filename.   For both systems,  the 
  50. stamp displayed is normally  the last modify stamp.   If the last modify stamp
  51. is not found,  the create stamp is instead displayed, and the date is followed
  52. by  a lower-case 'c'.   Since CP/M Plus defines  the same field for either the
  53. Update or Last Access stamp depending on the disk label, stamps designated 'c'
  54. may actually be the last access stamp, depending on the system.  The CP/M Plus
  55. 'SHOW d:[LABEL " command will display what stamps are active on a given disk.
  56.  Usage - 2/2 
  57.  
  58.    If no datestamps are available on the disk(s), just the filename(s) appear.
  59. If datestamping is active,  but the file(s) do  not  have valid stamps (day is
  60. not in  range 1..31),  two  dashes  will  appear  instead  of one  between the 
  61. filename and the line number.
  62.  
  63.    CPA buffers as much of both files  as TPA permits.   This  allows a limited
  64. 'back up' facility, but if the files are larger than the available memory, you
  65. will not be able to back up to  the beginning of  one or both files;  you must
  66. restart CPA to review these areas.
  67. :3
  68.  CPA Notes - 1/2 
  69.  
  70.    a. Vs 1.3 updates (7/5/91, Bruce Morgen):
  71.       - Meticulous maintenance update to reduce tool size to  32  records (4K)
  72.         from 34 records.  No observable functional alterations.  
  73.       - Biggest single savings came from  eliminating  use of  PRINT  routine,
  74.         used VPRINT (needed it regardless) calls instead.  
  75.       - The Z3 test (such as it is) is  done  earlier now  (before the program
  76.         banner is shown), so now VPRINT isn't called unless we  know we've got
  77.         a decent size stack to work with.  
  78.       - CPA now exits via DINIT, as we we should since we call TINIT.
  79.  
  80.    b. Vs 1.2 updates (2/20/89, Carson Wilson):
  81.       - Adds Z3PLUS datestamp support.
  82.       - Separates code from data segments.
  83.       - Uses SFXIO routines and 4k I/O buffers for better performance.
  84.       - Fixes bug at GETNXTLN which caused read past end of file.
  85.       - Adds datestamp display to DISP_SCREEN.
  86.       - For faster operation,  will not  refresh  the whole screen if keyboard
  87.         input is available (G, ^E, ^X commands).
  88.       - Allows user interrupt during long compares.
  89.  CPA Notes - 2/2 
  90.  
  91.       - Uses defaults for missing parts of command line (e.g., if second file-
  92.          name is missing, uses first filename for both).
  93.       - Adds built-in help.
  94.       - Adds ZCPR environment detection (aborts unless ZCPR present).
  95.       - Adds comments to clarify code (hint:  study the data structures at the
  96.         end of CPA.Z80 before tackling the code).
  97.       - Comments .NEW's and renames labels for Z80ASM.
  98.