home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / ZCPR33 / A-R / CPA12.LBR / CPA12.DZC / CPA12.DOC
Text File  |  2000-06-30  |  4KB  |  109 lines
  1.                    CPA - ComPare Ascii utility
  2.                         for ZCPR Systems
  3.  
  4.                 by Malcom Kemp and Carson Wilson
  5.                             20 Feb 89
  6.  
  7.      The CPA utility will analyze two text files on a line by line 
  8. basis, reporting any differences through a split screen with one 
  9. window per file.  For purposes of this utility, lines are limited 
  10. to 1015 characters and are terminated by a <CR><LF> pair.  Also, 
  11. before comparison, all tab characters are expanded.  Lines of 
  12. lengths longer than the screen width will wrap, causing following 
  13. of the lines in BOTH windows to scroll down.
  14.  
  15.      The utility is invoked as "CPA [dir:]ufn [dir:][ufn]", where 
  16. the file specifications must be unambiguous, but otherwise any 
  17. allowable Z-system specification.  If a file is missing, or a 
  18. line exceeding 1015 characters is found in a file, CPA exits to 
  19. the operating system with the appropriate error message.
  20.  
  21.      The compare will proceed until a mismatch occurs or until the 
  22. end of one or both files is reached, whichever comes first.  At 
  23. this time, the names and current lines, and file date stamps if 
  24. available are displayed.
  25.  
  26.      If a mismatch was found, the mismatched line will be shown as 
  27. the last line in each display.  The user can then manipulate the 
  28. lines in each screen to achieve synchronization, and begin the 
  29. compare again.  The compare will continue from the line AFTER the 
  30. displayed line forward.
  31.  
  32.      If your terminal supports video attributes, the display will 
  33. highlight the text in each window beyond the point of mismatch.  
  34. Under ZSDOS or Z3PLUS, file datestamps are displayed along with 
  35. each filename.  For both systems, the stamp displayed is normally 
  36. the last modify stamp.  If the last modify stamp is not found, the 
  37. create stamp is instead displayed, and the date is followed by a 
  38. lower case 'c'.  Since CP/M Plus defines the same field for either 
  39. the Update or Last Access stamp depending on the disk label, 
  40. stamps designated 'c' may actually be the last access stamp, 
  41. depending on your particular system.  Use the CP/M Plus "SHOW 
  42. d:[LABEL" command to tell what stamps are active on a particular 
  43. disk.
  44.  
  45.      If no datestamps are available on the disk(s), just the 
  46. filename(s) appear.  If datestamping is active, but the file(s) 
  47. do not have valid stamps (day is not in range 1..31), two dashes 
  48. will appear instead of one between the filename and the line 
  49. number.
  50.  
  51.      CPA buffers as much of both files a TPA permits.  This 
  52. allows a limited "back up" facility, but if the files are larger 
  53. than the available memory, you will not be able to back up to the 
  54. beginning of one or both files; you must restart CPA to review 
  55. these areas.
  56.  
  57.      Five commands are available while CPA is active:
  58.  
  59.      X, ^X     - Scroll the current screen up.
  60.  
  61.      E, ^E     - Scroll the current screen down.
  62.  
  63.      <sp>, S   - Switch screens.
  64.  
  65.      G         - Go on comparing at the next pair of lines.
  66.  
  67.      ^C        - Abort to operating system.
  68.  
  69.  
  70. 1.  ^X - Scroll up.
  71.  
  72.      Pressing X or control-X causes the current screen to scroll 
  73. up (move forward in the file) one line at a time until the end of 
  74. the file is reached.
  75.  
  76. 2.  ^E - Scroll down.
  77.  
  78.      Pressing E or control-E causes the current screen to 
  79. scroll down (move backward in the file) one line at a time until 
  80. either line one of the file or the beginning of the current 
  81. bufferful of text is reached.  While CPA uses all available 
  82. TPA to buffer text, large files may 
  83.  
  84. 3.  <sp> - Switch screens.
  85.  
  86.      Pressing the space bar or S toggles scroll control between 
  87. windows.  Scroll up and Scroll down commands now affect the 
  88. alternate window.
  89.  
  90. 4.  G - Go on comparing at the next pair of lines.
  91.  
  92.      Pressing G causes CPA to continue comparing the files until 
  93. the next mismatch or until the end of one or both files is 
  94. reached.
  95.  
  96. 5.  ^C - Abort to operating system. 
  97.  
  98.      Pressing control-C at any time aborts the file compare and 
  99. returns you to the operating system.
  100.  
  101.  
  102. Carson Wilson is the author of this version of CPA, based on 
  103. Malcom Kemp's original version 1.0.  Carson Wilson is the 
  104. operator at 
  105.  
  106.          Antelope Freeway Remote Access System, Chicago
  107.                           312/764-5162
  108.                   300/1200/2400 baud - 24 hours
  109.