home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / COMP67.ZIP / COMP.DOC < prev    next >
Text File  |  1990-12-18  |  6KB  |  162 lines
  1.  
  2.         COMP  Version 6.7 December 18,1990
  3.         Copyright 1989,1990 Les J. Ventimiglia
  4.  
  5.         Introduction
  6.         ------------
  7.  
  8.         COMP (Binary COMPare files).  This utility allows one to 
  9.         compare all the files in one tree against those of another 
  10.         tree, great for checking backups.  COMP is released as
  11.         shareware.  Registration is required for the enhanced
  12.         version.
  13.  
  14.         COMP is an enhanced COMP command supporting directory
  15.         recursion and HPFS long file names of OS/2 1.2 or later.
  16.  
  17.         This documentation describes the registered version of COMP. 
  18.         The non-registered version does not support the /e or /s
  19.         options. Nor does it display the mis-matches found.
  20.  
  21.         COMP is provided in a protected mode version as well as a
  22.         bound version for use in DOS or OS/2.
  23.  
  24.         The zip file should contain the following files:
  25.  
  26.                 COMP.EXE        Protected mode executable.
  27.                 BCOMP.EXE       Bound executable.
  28.                 COMP.DOC        This document file.
  29.  
  30.         Change History
  31.         --------------
  32.  
  33.         Version 6.0 24jun90 was the first release as Shareware.
  34.         Version 6.1 15aug90 Modified display of data mismatch offset
  35.                             from decimal to hexidecimal.
  36.         Version 6.2 11sep90 Fixed "comp x: y:" bug.
  37.                             Fixed "comp *.xyz *.x" bug.
  38.                             Fixed protected mode wild card matching.
  39.         Version 6.3 11oct90 Increased compare buffer size to 32k from 20k
  40.         Version 6.4 12oct90 Added code to display first 10 mismatches.
  41.         Version 6.5 19nov90 Increased compare buffer size to 32k from 20k
  42.         Version 6.6 09dec90 Fixed "comp abc.* efg.*" bug
  43.         Version 6.7 18dec90 Split into registered and non-registered
  44.                             versions.
  45.  
  46.         Syntax
  47.         ------
  48.  
  49.         COMP [/ems] filespec1 filespec2
  50.  
  51.         Where : /m = Mono (no color).
  52.                 /? = Displays usage summary.
  53.  
  54.                 /e = Display errors only.  
  55.                 /s = Traverse all subdirectories below the ones
  56.                      specified.
  57.  
  58.                 filespec1 is the source file or directory
  59.  
  60.                 filespec2 is the target file or directory    
  61.         
  62.         Wild card characters are accepted in the filespecs. Long file
  63.         names containing spaces should be enclosed in quotes.
  64.  
  65.         / options can be combined or be specified separately before or
  66.         after any of the filespecs.
  67.         
  68.         /se == /s/e == /s /e  
  69.  
  70.         The following errors may appear:
  71.         
  72.         NOT FOUND     : The target file could not be found.
  73.         SIZE MISMATCH : The source and target are of different sizes.
  74.         DATA MISMATCH @XXXXXXXX : The source and target are the same
  75.                       size, but differ in content starting at xxxxxxx.
  76.                 
  77.         EXAMPLES
  78.         --------
  79.         
  80.         To check the contents of one tree on drive c: against the
  81.         contents of your backup on drive d:
  82.  
  83.                 COMP c:\source d:\target /s
  84.  
  85.         The same operation as above but showing errors only:
  86.  
  87.                 COMP /se c:\source d:\target
  88.  
  89.         To compare only assembler source files in the current
  90.         directory against those in the parent directory:
  91.  
  92.                 COMP *.asm ..
  93.  
  94.         ERRORLEVEL
  95.         ----------
  96.  
  97.         Since COMP sets the errorlevel on return to the command
  98.         prompt, it can be used in batch files.  The Errorlevel will
  99.         be set to a value between 0 and 7 as follows:
  100.  
  101.                 No errors found returns 0.
  102.                 Any target files not found will OR in a 1.
  103.                 Any file size mis-matches wll OR in a 2.
  104.                 Any file data mis-compares will OR in a 4.
  105.  
  106.         Thus if any target files are not found and if there is a data
  107.         mis-compare, the errorlevel will be set to 4 OR'd with 1 = 5.
  108.  
  109.         SHAREWARE
  110.         ---------
  111.  
  112.         COMP is distributed under the SHAREWARE concept.
  113.         You are encouraged to copy and share this program with other users.
  114.         Please do not remove the copyright or the user-supported notice.
  115.         If you enjoy COMP and find it of value and wish to receive
  116.         the enhanced version, send $10 to the address at the end of the 
  117.         file.
  118.         
  119.         COMP is one of the "Ventimiglia Tools" family of programer
  120.         enhancement utilities.  Look for more of these enhancement
  121.         utilities coming soon to a BBS near you.
  122.  
  123.         SHAREWARE is based on these three beliefs:
  124.  
  125.         1.  The value of software is best assessed by the
  126.             user on his own system.
  127.         2.  Creation of personal computer software can and
  128.             should be supported by computing community.
  129.         3.  That copying of programs should be encouraged,
  130.             rather than restricted.
  131.  
  132.  
  133.         Copyright/License/Warranty
  134.         --------------------------
  135.  
  136.         This document and the current version of the program file
  137.         COMP.EXE ("the software") are copyrighted by the author. The
  138.         copyright owner hereby licenses you to: use the software; make
  139.         as many copies of the program and documentation as you wish;
  140.         give such copies to anyone; and distribute the software and
  141.         documentation via electronic means.
  142.  
  143.         However, you are specifically prohibited from charging, or
  144.         requesting donations, for any such copies, however made. 
  145.  
  146.         No copy of the software may be distributed or given away without
  147.         this document; and this notice must not be removed.
  148.  
  149.         There is no warranty of any kind, and the copyright owner is not
  150.         liable for damages of any kind. By using the software, you agree
  151.         to this.
  152.  
  153.         Contact
  154.         -------
  155.  
  156.         Send registration fees and/or questions to :
  157.  
  158.         Les J. Ventimiglia
  159.         15247 Monroe Ave.
  160.         Moorpark, CA. 93021
  161.         (805) 529-6370
  162.