home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / zsys / znode-12 / s / z3help10.lbr / CPA.HZP / CPA.HLP
Encoding:
Text File  |  1993-06-12  |  4.0 KB  |  91 lines
  1. ;
  2.                                     CPA.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                5k (34)   367C  1.2        Carson Wilson 2/89       Z3COM2
  6.  
  7.   1- Syntax  2- Usage  3- Notes                                               
  8.  
  9.  
  10.    ComPare Ascii utility will analyze two files, on a line by line basis,  and
  11. report any differences.  Version 1.0 by Malcom Kemp (1/87).
  12.  
  13.    For purposes of  this  utility,  lines  are terminated by  a <CR><LF> pair.  
  14. Also,  before comparison,  all tab  characters are expanded.   Lines of length 
  15. longer than a screen width will wrap, causing following of the lines in BOTH 
  16. windows to scroll down.
  17. :1
  18.  
  19.  
  20.    Syntax:  CPA [dir:]ufn [dir:][ufn]
  21.  
  22.    ... where the file specification  must  be  unambiguous,  but otherwise any
  23. allowable Z-system specification.   If a file is missing,  or a line exceeding
  24. 1015 characters is found in a file, CPA exits to the operating system with the
  25. appropriate error message.
  26.  
  27.  
  28.    Commands while CPA is active:
  29.  
  30.           X, ^X  - Scroll the current screen up
  31.           E, ^E  - Scroll the current screen down
  32.         <sp>, S  - Switch screens
  33.               G  - Go on comparing at the next pair of lines  
  34.              ^C  - Abort to operating system
  35. :2
  36.  
  37. Usage:
  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.  
  57.  
  58.  
  59. Usage (cont'd):
  60.  
  61.    If no datestamps are available on the disk(s), just the filename(s) appear.
  62. If datestamping is active,  but the file(s) do  not  have valid stamps (day is
  63. not in  range 1..31),  two  dashes  will  appear  instead  of one  between the 
  64. filename and the line number.
  65.  
  66.    CPA buffers as much of both files  as TPA permits.   This  allows a limited
  67. 'back up' facility, but if the files are larger than the available memory, you
  68. will not be able to back up to  the beginning of  one or both files;  you must
  69. restart CPA to review these areas.
  70. :3
  71.  
  72. CPA Notes:
  73.  
  74.    a. Vers 1.2: 
  75.  
  76.       Adds Z3PLUS datestamp support.
  77.       Separates code from data segments.
  78.       Uses SFXIO routines and 4k I/O buffers for better performance.
  79.       Fixes bug at GETNXTLN which caused read past end of file.
  80.       Adds datestamp display to DISP_SCREEN.
  81.       For faster operation,  will not  refresh  the  whole  screen if keyboard
  82.          input is available (G, ^E, ^X commands).
  83.       Allows user interrupt during long compares.
  84.       Uses defaults for missing parts of command line (e.g., if second 
  85.          filename is missing, uses first filename for both).
  86.       Adds built-in help.
  87.       Adds ZCPR environment detection (aborts unless ZCPR present).
  88.       Adds comments to  clarify code (hint:  study the data structures  at the 
  89.          end of CPA.Z80 before tackling the code).
  90.       Comments .NEW's and renames labels for Z80ASM.
  91.