home *** CD-ROM | disk | FTP | other *** search
/ ftp.update.uu.se / ftp.update.uu.se.2014.03.zip / ftp.update.uu.se / pub / rainbow / msdos / decus / RB101 / diff.doc < prev    next >
Text File  |  1995-05-19  |  4KB  |  82 lines
  1.  
  2.  
  3.  
  4.                 DIFF - A Text-file Differencing Program
  5.  
  6.      This is a utility to compare two text files (e.g.,  two versions of 
  7.      a  program  source  file)  and print the lines which differ between 
  8.      them.  The algorithm  used  is  that  of  J.  W.  Hunt  and  M.  D. 
  9.      McIlroy,  "An  algorithm  for  differential file comparison",  Bell 
  10.      Telephone Laboratories Computing Science Technical Report #41. 
  11.  
  12.      Usage is 
  13.  
  14.                      diff [option ...] file1 file2 
  15.  
  16.      The options, or switches, are in the UNIX style of -s -t etc.  They 
  17.      cannot be concatenated (e.g.,  -st ),  but they  may  be  used  any 
  18.      number  of times on the command line in any order.  If incompatible 
  19.      switches, such as -s and -l, are both specified, the last-occurring 
  20.      switch is valid. 
  21.  
  22.      The following options are available: 
  23.  
  24.           -l  -  "line" mode, i.e.,  compare  files  record  by  record,
  25.           where a record is terminated by a newline.  Only the first 256
  26.           characters of the records are compared and printed.   This  is
  27.           the default.
  28.  
  29.           -s  -  "sentence" mode.  Here, records  are  terminated  by  a
  30.           period,   colon,   or  semicolon.   Newlines  and  white-space
  31.           characters are converted to spaces, and consecutive spaces are
  32.           converted  to  a  single  space.   Records  also  end  at  256
  33.           characters, but the remainder  of  the  record  is  not  lost;
  34.           rather,  the  next  record  starts where the previous one left
  35.           off.
  36.  
  37.           -c[n1[:[n2]]]  -  column restriction.  The comparison  between
  38.           two records is restricted to columns n1 through n2.  Either or
  39.           both numbers are optional;  if not present, each has a default
  40.           (if  n2  is present, the colon must be included).  n1 defaults
  41.           to 1, n2 to 256.
  42.  
  43.           -m[n1]  -  specifies the  number  of  records  constituting  a
  44.           match;    that   is,  if  a  mismatch  is  detected,  then  n1
  45.           consecutive pairs of matching lines must  be  found  before  a
  46.           match is declared again.  n1 defaults to 1.
  47.  
  48.      A typical invocation might be
  49.  
  50.                     diff -c10:20 -m3 prog.v1 prog.v2
  51.  
  52.      This command would cause  the  files  prog.v1  and  prog.v2  to  be
  53.      compared line by line, and those lines which differed in columns 10
  54.      through 20 would be listed in sections.  A difference section would
  55.      end  only  when  a  sequence  of  three  or more matching lines (in
  56.      columns 10 through 20) were found.
  57.                                                                   Page 2
  58.  
  59.  
  60.      The output of DIFF is similar to the default output of the  VAX/VMS
  61.      DIFFERENCES command.  However, the algorithms are not the same, and
  62.      in some unusual circumstances their sets of  difference  lines  can
  63.      differ  for  the  same values of the match record option.  However,
  64.      the difference sets will always include all unmatched lines.
  65.  
  66.  
  67.      Bugs (features) in V1.30 -
  68.  
  69.      The  filenames must be in the current directory.  This is a problem 
  70.      caused by the Microsoft C compiler.  A later version of Lattice  C, 
  71.      or  somebody  else's  compiler,  will  doubtless  permit  filespecs 
  72.      including pathnames. Watch this space. 
  73.  
  74.      DIFF currently has no options for output format.
  75.  
  76.      DIFF will probably not be sensible about handling internal  formats
  77.      used by word processors such as Wordmarc or Multi-mate.
  78.      
  79.      If you have any suggestions,  please  contact  C. K. Miller,  7613,
  80.      4-4079.
  81. aé "σV      EXEx╝.
  82. Ç3