home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / util4 / handy.lzh / CWEEP.DOC < prev    next >
Text File  |  1985-02-07  |  9KB  |  273 lines
  1.  
  2.                             CWEEP version 1.30
  3.                     File maniulation utility for MS-DOS
  4.                                29-June-1984
  5.  
  6.  
  7.                                 CWEEP V1.30
  8.      
  9.                             Copyright (c) 1984
  10.      
  11.                                     by
  12.                                Gary M. Berg
  13.                         5850 Duncraig Dr., Apt. 806
  14.                              Dayton, OH  45426
  15.                               CIS 70106, 1624
  16.      
  17.      
  18.           This software is released to the public domain and may be
  19.      freely reproduced and distributed as long as such is not for
  20.      gain.  The author provides to warranty of fitness or accuracy of
  21.      the software.
  22.      
  23.           CWEEP was inspired by the CP/M utility SWEEP.  CWEEP
  24.      provides the same capabilities to a Z-DOS/MS-DOS system user
  25.      which SWEEP provides to the CP/M user.  This program does not
  26.      attempt to provide all of the capabilities which the NEWSWEEP
  27.      programs do, but provides some additional extensions to provide
  28.      capabilties which I have found useful.
  29.      
  30.           The following is an alphabetic list of the commands provided
  31.      in CWEEP:
  32.      
  33.       sp/cr    Advance to the next file in the list.
  34.         A      Again.  Retag all files which display a "#" in the tag
  35.                field.  Used for copying a set of files to more than
  36.                one disk, or for deleting a set from a disk after they
  37.                have been copied elsewhere.
  38.      
  39.         B      Back up to previous file in list.
  40.      
  41.         C      Copy a single file to another dirve.  Asks for
  42.                destination drive.  Form is d[:[v]]; specifying "v"
  43.                will cause the copy to be verified.  Examples:
  44.      
  45.                b    Copy to drive B:
  46.                b:   Same as above
  47.                b:v  Copy file to drive B:, and verify the copy
  48.                     afterward by re-reading the file and comparing the
  49.                     resulting CRC with the CRC computed when the file
  50.                     was read from the source disk.
  51.      
  52.                In all cases the date/time will be correctly copied to
  53.                the output file.  This will NOT support MS-DOS 2.0
  54.                subdirectory names.
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                  Page -1-
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                             CWEEP version 1.30
  71.                     File maniulation utility for MS-DOS
  72.                                29-June-1984
  73.  
  74.  
  75.      
  76.        -C      Copy file to another name.  User must specify a
  77.                complete output file name.  Asks for verify or not.
  78.      
  79.         D      Delete an individual file.  Asks for Y/N to confirm.
  80.      
  81.         E      Erase all tagged or untagged files.  Optional file by
  82.                file confirmation is available.  This option is more
  83.                robust than the corresponding option is SWEEP V3.8;
  84.                the user must specify [T]agged or [U]ntagged.
  85.                Otherwise, the input is ignored.
  86.      
  87.         F      Free space on a drive.  Note that this is a different
  88.                letter than in SWEEP.  Will give correct results for
  89.                both Z-DOS 1.1 and MS-DOS 2.x.
  90.      
  91.         H      Hexidecimal dump of file to screen.
  92.        -H      Hex dump of file to screen; pauses at the end of each
  93.                256 byte segment.
  94.        +H      Hex dump of file to screen and printer.
  95.      
  96.         I      Information.  Prints size in bytes and time for file,
  97.                since there was insufficient space on regular prompt
  98.                line to display this information.
  99.      
  100.         J      Jump to a file in the list.  Works if list is ordered
  101.                by file name or extension.  Examples:
  102.      
  103.                S         Jump to first "S" or extension blank.
  104.                A.BAT     Jumps to "A"'s or ".BAT" extensions.
  105.      
  106.                Jump positions you after the matching files if the list
  107.                is sorted in inverse order.
  108.      
  109.         L      Log in new drive and files.  Can specify a wildcard to
  110.                match or just a drive.
  111.      
  112.         M      Mass copy of tagged files to a specified drive.  Drive
  113.                is specified the same way as for copy command, and may
  114.                include the verify option.
  115.      
  116.        -O      Output a list of tagged files to a specified disk file
  117.                name.  May specify "CON" or "PRN" for name; will query
  118.                if the output file should be deleted if it already
  119.                exists.
  120.      
  121.        +O      Output a list of untagged files the same as "-O".
  122.      
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                  Page -2-
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.                             CWEEP version 1.30
  139.                     File maniulation utility for MS-DOS
  140.                                29-June-1984
  141.  
  142.  
  143.         P      Protected mass copy of tagged files.  Same as "M" but
  144.                will ask if a file should be deleted if it exists on
  145.                the output drive.
  146.      
  147.        -Q      Provide a list of tagged files to screen.
  148.        +Q      Provide a list of untagged files to screen.
  149.      
  150.         R      Rename a file.  Enter new name.  If new name is "*",
  151.                will ask for an input wildcard, and a new wildcard for
  152.                renaming those files, as SWEEP does.
  153.      
  154.         S      Sort the directory listing.  Can sort by name,
  155.                ext/name, size, and date.  Lead in with "-" to sort by
  156.                inverse of whatever.  Date is great for copying off
  157.                what you last changed.
  158.      
  159.         T      Tag a file.  Marks with "*" in list.
  160.      
  161.         U      Untag a file.  Removes "*" from list.
  162.      
  163.         V      View a file to screen.  We use Spellbinder for out
  164.                wordprocessor, so the view option throws away all line
  165.                feeds, translate <CR> and <VTAB> to a <CR><LF> when
  166.                displaying on the screen.  Normally, this causes no
  167.                problem with text files.  The display can be paused by
  168.                pressing any key except <ESC> or <CR>; those terminate
  169.                the view command.  The same choice of keys can be used
  170.                to restart the display.
  171.      
  172.        -V      View as above, but pause every 22 <CR>'s.
  173.        +V      View to screen and printer.
  174.      
  175.         W      Tag all files matching a wildcard name.ext.
  176.        -W      Tag all files not matching a wildcard name.ext.
  177.      
  178.         Z      Change an MS-DOS 2.x subdirectory name.  When I saw how
  179.                simple it was to emulate a CHDIR command, I put it in.
  180.                Note that you can only be in one subdirectory at a time
  181.                on any given drive, and that there is no way to copy
  182.                from one subdir to another in this version.
  183.      
  184.      ? or /    Print help list.  Re-prints the informational message
  185.                printed by CWEEP at startup.  If preceeded by a "-" or
  186.                "+", will print a help message for all command which
  187.                are prefxed in that manner.
  188.      
  189.           As an interesting note, control-P and control-N work to
  190.      toggle printer echo on/off, since this program uses the BDOS
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.                                  Page -3-
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.                             CWEEP version 1.30
  207.                     File maniulation utility for MS-DOS
  208.                                29-June-1984
  209.  
  210.  
  211.      calls to do all I/O to the keyboard.  This can be disconcerting
  212.      if you aren't expecting it.  It also means you can get a listing
  213.      of exactly what you did, and get crude directory listings sorted
  214.      by all of the list sort orders.
  215.      
  216.      
  217.           I wrote CWEEP because in our company we were unable to
  218.      consider moving our users from CP/M to Z-DOS without some such
  219.      capability.  It is written in CI C-86, but does not use in of the
  220.      CI I/O subroutines.  The disk I/O routines came from an "unknown"
  221.      user on the Programmer's SIG [72155,1402], and the CRC routine is
  222.      the one used in YAM.
  223.      
  224.           CWEEP will not support I/O re-direction except as provided
  225.      directly by MS-DOS 2.0 for the BDOS calls.  Obviously, it can be
  226.      confusing to try and write redirection files for a program which
  227.      is so terminal interactive.
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.                                  Page -4-
  267.  
  268.  
  269.  
  270.  
  271.  
  272.