1 COMPARE
 Compares the contents of two sets of files and creates a listing  of the
 files which do not match (in terms of filename, type, external version
 number, size, file creation date, and/or file revision date).

 Format:

      COMPARE master-file-spec copy-file-spec
2 Parameters
 master-file-spec

  Specifies  the primary set of files.  The "master-file-spec" may be
  a wildcard specification or may indicate the name of a previously
  created list of file names (created by a directory command such as:
  DIRECTORY/OUTPUT=dirname/NOHEAD/NOTRAIL file-spec).  If the second
  option is desired, the /DIRECTORY qualifier must be used.

 copy-file-spec

  Specifies  the secondary set of files.  The "copy-file-spec" may be
  a wildcard specification or may indicate the name of a previously
  created list of file names (created by a directory command such as:
  DIRECTORY/OUTPUT=dirname/NOHEAD/NOTRAIL file-spec).  If the second
  option is desired, the /DIRECTORY qualifier must be used.

2 Qualifiers

/CREATION_DATE 

   /CREATION_DATE  (D)  
   /NOCREATION_DATE

 Determines whether creation date and time are used in comparing
 corresponding files.  (Corresponding files are files which have the 
 same filename, the same type, and are in the same relative position
 within the directory hierarchies specified in the master- and copy-
 file-specs.)  If the /DIRECTORY option was used, /CREATION_DATE may
 only be used if the directory file was created using the DIRECTORY
 DIRECTORY command with the /SIZE, /DATE=(CREATED,MODIFIED), and 
 /WIDTH=(FILENAME=80,DISPLAY=132) qualifiers.  The /WIDTH qualifier
 is required to keep the entire directory entry for each file
 on one line.

/REVISION_DATE   

   /REVISION_DATE  
   /NOREVISION_DATE  (D)

 Determines whether revision date and time are used in comparing
 corresponding files.  (Corresponding files are files which have the 
 same filename, the same type, and are in the same relative position
 within the directory hierarchies specified in the master- and copy-
 file-specs.)  If the /DIRECTORY option was used, /REVISION_DATE may
 only be used if the directory file was created using the DIRECTORY
 DIRECTORY command with the /SIZE, /DATE=(CREATED,MODIFIED), and 
 /WIDTH=(FILENAME=80,DISPLAY=132) qualifiers.  The /WIDTH qualifier
 is required to keep the entire directory entry for each file
 on one line.



/SIZE

   /SIZE  (D)  
   /NOSIZE

 Determines whether "used" file size is used in comparing
 corresponding files.  (Corresponding files are files which have the 
 same filename, the same type, and are in the same relative position
 within the directory hierarchies specified in the master- and copy-
 file-specs.)  If the /DIRECTORY option was used, /SIZE may only be
 used if the directory file was created using the DIRECTORY
 command with the /SIZE or /SIZE=ALL and
 /WIDTH=(FILENAME=80,DISPLAY=132) qualifiers.  The /WIDTH qualifier
 is required to keep the entire directory entry for each file
 on one line.



/VERSION

   /VERSION  (D)  
   /NOVERSION

 Determines whether external version numbers are used in comparing
 corresponding files.  (Corresponding files are files which have the 
 same filename, the same type, and are in the same relative position
 within the directory hierarchies specified in the master- and copy-
 file-specs.)


/OUTPUT

   /OUTPUT[=file-spec]

 Defines an output file to receive the output difference  list.   If
 you  omit  the  /OUTPUT  qualifier,  the  output  is written to the
 current SYS$OUTPUT device.  If you specify /OUTPUT without  a  file
 specification,  the output is directed to the file "COMPARE.DAT".

 No wild card characters are allowed in the file specification.


/DIRECTORY

   /DIRECTORY
   /NODIRECTORY  (D)

 Indicates that the file-spec describes a directory file (such as
 would be produced by the directory command using the /NOHEADER
 and /NOTRAILER qualifiers) instead of a wildcard specification. 
 Each line of the file must contain a complete file name including
 device, directory, filename, type, and version number.  The files
 must be in the same order as would be produced by the directory
 command. If comparisons using size (/SIZE qualifier) or date
 (/CREATION_DATE and /REVISION_DATE qualifiers) is desired, then
 each line must also contain the size and dates as produced by
 the DIRECTORY command with the /SIZE, /DATE=(CREATED,MODIFIED), and 
 /WIDTH=(FILENAME=80,DISPLAY=132) qualifiers.  The /WIDTH qualifier
 is required to keep the entire directory entry for each file
 on one line.


