home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 262.lha / ArpDoc_v1.3 / Cmp < prev    next >
Text File  |  1989-07-01  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4.      Cmp(V1.3)               ARP User's Manual               Cmp(V1.3)
  5.  
  6.  
  7.  
  8.      NAME
  9.           Cmp - Compare files and report differences.
  10.  
  11.      SYNOPSIS
  12.           Cmp From/a With/a FULL/s QUICK/s ALL/s
  13.  
  14.      DESCRIPTION
  15.           Use Cmp to display differences between binary or text files.
  16.           When comparing single files, the return code will be set to
  17.       WARN if the files do not match. This is useful in scripts
  18.       with IF statements.  The return code on complex pattern
  19.       matches with more than one file will always be zero. When
  20.       specifying directories as either the From or With arguments,
  21.       you may use a dot which means "current directory".
  22.  
  23.           You can use either C-e (Control E) or C-f (Control F) to
  24.           abort the comparison of the current files and move on to the
  25.           next.  This is most useful with multiple input files and the
  26.           FULL (see below) option.  As usual, a C-c (Control C) will
  27.           abort the program all together.
  28.  
  29.      INPUT FILES
  30.           You can specify the file or files to be compared quite
  31.           easily and naturally with Cmp using simple pathnames or
  32.           wildcard patterns or even directory names. When you specify
  33.           wildcards and/or directories to be compared, Cmp will
  34.           compare files with the same names in each directory.  Cmp
  35.           will not abort if it cannot find the second file, it will
  36.           simply print an informative message and go on to the next
  37.           file.  If you need to compare files with different names,
  38.           then you must specify each name in full as the With name and
  39.           the From name.  A more detailed explanation follows:
  40.  
  41.           If From is a file, then With may be either a directory or
  42.           another file.  If a directory is supplied, then Cmp looks
  43.           for a file with the same name as the From file in that
  44.           directory:
  45.  
  46.           Cmp File RAD:dir/File2  ; compare File with RAD:Dir/File2
  47.           Cmp File DirName    ; compare File with DirName/File
  48.  
  49.  
  50.           You may also use a wildcard pattern as the From file.  In
  51.           this case, the With name must be a directory.  Cmp expands
  52.           the wildcard specification and tries to find files with that
  53.           name in the With directory:
  54.  
  55.           Cmp File RAD:Foo/*.c DF0:c
  56.  
  57.  
  58.           Finally, you can also use two directory names as the From
  59.           and With specification. This will compare all the files of
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/28/89)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      Cmp(V1.3)               ARP User's Manual               Cmp(V1.3)
  71.  
  72.  
  73.  
  74.           the same name in the From directory with all the files of
  75.           the same name in the With directory:
  76.  
  77.           Cmp Dir1 Dir2
  78.  
  79.  
  80.      OPTIONS
  81.           FULL This will display all points at which the two files
  82.                differ.  The display is of the form "Offset: Byte1
  83.                Byte2" where Offset is in decimal and Byte1 Byte2 are
  84.                in hex. Use C-e or C-f to move to the next file in the
  85.                series, or C-c to abort.
  86.  
  87.           QUICK
  88.                The QUICK option will check to see if the two files
  89.            appear to be identical, by first comparing the date
  90.            stamps and file lengths, and if these are the same
  91.            the file comparison is skipped saving some time.
  92.  
  93.           ALL  If there are subdirectories within the directories you
  94.                are comparing, the ALL switch will force Cmp to
  95.                recursively descend these directories, comparing files
  96.                as appropriate.
  97.  
  98.      OTHER
  99.           This command is new with V1.3 of ARP, it is not available
  100.           with the Commodore distribution.
  101.  
  102.      SEE ALSO
  103.           AshManual Execute If
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/28/89)
  130.  
  131.  
  132.  
  133.