home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / txtutl / df-11.ark / DF.DOC < prev   
Encoding:
Text File  |  1980-02-24  |  1.9 KB  |  46 lines
  1. DF - DIFFERENCE DISPLAY FOR PRINTABLE FILES - Version 1.1 2/24/80
  2.      by Richard Greenlaw, 251 Colony Ct., Gahanna, Ohio 43230
  3.  
  4. This program compares two text files and displays the differences. 
  5.  
  6. Finding the end of a difference between the files requires some 
  7. arbitrary rules since we don't want to generate a series of small 
  8. difference reports just because the old and new text have a few words 
  9. in common.
  10.  
  11. To avoid this problem, comparisons are on a "line" basis and the user 
  12. can specify the line delimiter character and how many lines must match 
  13. to end a difference.  The end of file mark is also a line delimiter, 
  14. but is not considered part of the line.  The null character is used as 
  15. an end of buffer mark and is converted to endfile if read from a file.
  16.  
  17. Note that the last line in a buffer may be incomplete but will be 
  18. treated as complete.
  19.  
  20. Since linefeeds and the delimiter are converted by the output routine 
  21. to CR-LF pairs, to avoid multiple linefeeds or carriage returns, the 
  22. user may specify one character code to be deleted from all file input.
  23.  
  24. The CP/M command line has the format:
  25.  
  26.     DF filea fileb options
  27.  
  28. where filea and fileb may include drives as in b:myname.doc and where 
  29. options consist of key letters followed immediately by a decimal 
  30. number.
  31.  
  32. Valid options are:
  33.      D decimal value of delimiter character
  34.      M number of lines which must match to end an area of difference
  35.      I decimal value of character code to be deleted on iniut.
  36. Defaults are linefeed, 2, carriage return.
  37.  
  38. Example:  DF A:XY.C B:XY.BAK M3 I10 D13
  39.  
  40. Ambiguous file names are not allowed.
  41.  
  42. Although normal, small areas of difference are processed quickly,
  43. large differences can take several minutes to analyze. Be patient.
  44.  
  45. The program can be run without arguments for help.
  46.