CWEEP version 1.30
                    File maniulation utility for MS-DOS
                               29-June-1984


                                CWEEP V1.30

                            Copyright (c) 1984

                                    by
                               Gary M. Berg
                        5850 Duncraig Dr., Apt. 806
                             Dayton, OH  45426
                              CIS 70106, 1624


          This software is released to the public domain and may be
     freely reproduced and distributed as long as such is not for
     gain.  The author provides to warranty of fitness or accuracy of
     the software.

          CWEEP was inspired by the CP/M utility SWEEP.  CWEEP
     provides the same capabilities to a Z-DOS/MS-DOS system user
     which SWEEP provides to the CP/M user.  This program does not
     attempt to provide all of the capabilities which the NEWSWEEP
     programs do, but provides some additional extensions to provide
     capabilties which I have found useful.

          The following is an alphabetic list of the commands provided
     in CWEEP:

      sp/cr    Advance to the next file in the list.
        A      Again.  Retag all files which display a "#" in the tag
               field.  Used for copying a set of files to more than
               one disk, or for deleting a set from a disk after they
               have been copied elsewhere.

        B      Back up to previous file in list.

        C      Copy a single file to another drive.  Asks for
               destination drive.  Form is d[:[v]]; specifying "v"
               will cause the copy to be verified.  Examples:

               b    Copy to drive B:
               b:   Same as above
               b:v  Copy file to drive B:, and verify the copy
                    afterward by re-reading the file and comparing the
                    resulting CRC with the CRC computed when the file
                    was read from the source disk.

               In all cases the date/time will be correctly copied to
               the output file.  This will NOT support MS-DOS 2.0
               subdirectory names.







                                 Page -1-





                            CWEEP version 1.30
                    File maniulation utility for MS-DOS
                               29-June-1984



       -C      Copy file to another name.  User must specify a
               complete output file name.  Asks for verify or not.

        D      Delete an individual file.  Asks for Y/N to confirm.

        E      Erase all tagged or untagged files.  Optional file by
               file confirmation is available.  This option is more
               robust than the corresponding option is SWEEP V3.8;
               the user must specify [T]agged or [U]ntagged.
               Otherwise, the input is ignored.

        F      Free space on a drive.  Note that this is a different
               letter than in SWEEP.  Will give correct results for
               both Z-DOS 1.1 and MS-DOS 2.x.

        H      Hexadecimal dump of file to screen.
       -H      Hex dump of file to screen; pauses at the end of each
               256 byte segment.
       +H      Hex dump of file to screen and printer.

        I      Information.  Prints size in bytes and time for file,
               since there was insufficient space on regular prompt
               line to display this information.

        J      Jump to a file in the list.  Works if list is ordered
               by file name or extension.  Examples:

               S         Jump to first "S" or extension blank.
               A.BAT     Jumps to "A"'s or ".BAT" extensions.

               Jump positions you after the matching files if the list
               is sorted in inverse order.

        L      Log in new drive and files.  Can specify a wildcard to
               match or just a drive.

        M      Mass copy of tagged files to a specified drive.  Drive
               is specified the same way as for copy command, and may
               include the verify option.

       -O      Output a list of tagged files to a specified disk file
               name.  May specify "CON" or "PRN" for name; will query
               if the output file should be deleted if it already
               exists.

       +O      Output a list of untagged files the same as "-O".








                                 Page -2-





                            CWEEP version 1.30
                    File maniulation utility for MS-DOS
                               29-June-1984


        P      Protected mass copy of tagged files.  Same as "M" but
               will ask if a file should be deleted if it exists on
               the output drive.

       -Q      Provide a list of tagged files to screen.
       +Q      Provide a list of untagged files to screen.

        R      Rename a file.  Enter new name.  If new name is "*",
               will ask for an input wildcard, and a new wildcard for
               renaming those files, as SWEEP does.

        S      Sort the directory listing.  Can sort by name,
               ext/name, size, and date.  Lead in with "-" to sort by
               inverse of whatever.  Date is great for copying off
               what you last changed.

        T      Tag a file.  Marks with "*" in list.

        U      Untag a file.  Removes "*" from list.

        V      View a file to screen.  We use Spellbinder for our
               wordprocessor, so the view option throws away all line
               feeds, translate <CR> and <VTAB> to a <CR><LF> when
               displaying on the screen.  Normally, this causes no
               problem with text files.  The display can be paused by
               pressing any key except <ESC> or <CR>; those terminate
               the view command.  The same choice of keys can be used
               to restart the display.

       -V      View as above, but pause every 22 <CR>'s.
       +V      View to screen and printer.

        W      Tag all files matching a wildcard name.ext.
       -W      Tag all files not matching a wildcard name.ext.

        Z      Change an MS-DOS 2.x subdirectory name.  When I saw how
               simple it was to emulate a CHDIR command, I put it in.
               Note that you can only be in one subdirectory at a time
               on any given drive, and that there is no way to copy
               from one subdir to another in this version.

     ? or /    Print help list.  Re-prints the informational message
               printed by CWEEP at startup.  If preceeded by a "-" or
               "+", will print a help message for all command which
               are prefixed in that manner.

          As an interesting note, control-P and control-N work to
     toggle printer echo on/off, since this program uses the BDOS







                                 Page -3-





                            CWEEP version 1.30
                    File maniulation utility for MS-DOS
                               29-June-1984


     calls to do all I/O to the keyboard.  This can be disconcerting
     if you aren't expecting it.  It also means you can get a listing
     of exactly what you did, and get crude directory listings sorted
     by all of the list sort orders.


          I wrote CWEEP because in our company we were unable to
     consider moving our users from CP/M to Z-DOS without some such
     capability.  It is written in CI C-86, but does not use any of the
     CI I/O subroutines.  The disk I/O routines came from an "unknown"
     user on the Programmer's SIG [72155,1402], and the CRC routine is
     the one used in YAM.

          CWEEP will not support I/O re-direction except as provided
     directly by MS-DOS 2.0 for the BDOS calls.  Obviously, it can be
     confusing to try and write redirection files for a program which
     is so terminal interactive.






































                                 Page -4-