;
                                 CSWEEP.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
              15k (120)  AAA8  3.0        Lindsay Haisley          Z3COM2

  1- Syntax/Options  2- Notes  3- Examples of Use                             

   CSWEEP  is a file copy program similar in function to the popular SWEEP and
NEWSWEEP programs,  except that it operates entirely from command line options 
and has no interactive mode.  It differs from PIP in that it allows:

   1. Multiple copies to and from different du: areas with a single operation
   2. ZCPR3 style du: access.
   3. Deletion of source files after copying
   4. True CRC file copy checking
   5. Archiving support for making disk backups
   6. Pre-copy file size and disk freespace check
:1

   Syntax:  CSWEEP du:f1 [du:f2 .. du:fn] ddu1: [ddu2: ... ddu6:] [options]

f1, f2, etc.      <-- Ambiguous file names (! prefix excludes)
ddu1:, ddu2, etc. <-- Destination disk/user or * for current

  Options:  -v    <-- Verify (CRC)
            -d    <-- Delete source copies
            -q    <-- Report stats only
            -r    <-- Report stats and copy
            -a    <-- Copy non-archived files and archive source after copying
            -s    <-- Exclude system files from copy

   All du: designations are in  the form of  a drive letter followed by a user 
area  number followed by a colon, as in the example above.   If either spec is
omitted,  the current du: is assumed.   Any other format will be flagged as an
error.  The use of the "*" for any destination du: spec designates the current
disk drive and user area.   Filenames,  du: specs and options may be  given in
any order.
:2
    
CSWEEP Notes:

   a. CSWEEP is extremely useful for copying  or moving files with any program
      or  operating system that uses  command files,  such as SUBMIT.  It will
      also save  many  keystrokes  over SWEEP or NEWSWEEP  when  moving  large
      numbers  of files  around in your disk system.   CSWEEP is  as  fast  or
      faster than these programs for all types of file copy operations.

   b. CSWEEP accepts ambiguous file names  of the standard CP/M sort  with one
      addition.   An ambiguous  file name (afn) preceded  by a "!" causes  all
      names matching the given afn  to  be EXCLUDED from  the  resulting copy.
      When giving  a "!" afn,  "*" chars  in  the string match  to the  end of
      either the filename or extension,  just like CP/M,  but "?" chars  match
      ONE and ONLY ONE character in either the filename or extension.


CSWEEP Notes (continued):

   c. CSWEEP will copy  all files  as instructed unless  a BDOS  file error is
      encountered in  the copy process.   If an  error occurs  in creating  or
      writing to a copy file, CSWEEP will report the error, delete the partial
      copy (if any) and drop  the du: in which the error occurred from further
      copy operations.   Under the -d option,  if  a write error  of  any sort
      occurs during a file copy,  the source file will NOT be deleted.   After
      completing  its work,  CSWEEP will report  a tally of files  copied  and
      errors encountered.

   d. If any of the files to be copied already exist on a target disk then the
      space  report  for that  disk will  be in error.   New files will simply
      overwrite old files of the same name.
:3

Examples of Use:

   a. A>CSWEEP *.* !*.COM B: C0:   

      -- Copy all files except *.COM files from the current du: to B: and C0:.
