home *** CD-ROM | disk | FTP | other *** search
/ ftp.update.uu.se / ftp.update.uu.se.2014.03.zip / ftp.update.uu.se / pub / rainbow / msdos / misc / sweep.lzh / SWEEP214.DOC < prev   
Text File  |  1985-06-26  |  17KB  |  421 lines
  1.  
  2.                     CWEEP - A SWEEP-like program for MS-DOS
  3.  
  4.  
  5.                                 By Gary M. Berg
  6.                               5850 Duncraig Drive
  7.                                  Apartment 806
  8.                               Dayton, Ohio   45426
  9.      
  10.                               C.I.S. # 70106,1624
  11.      
  12.             Copyright (C) 1984, 1985 by Gary M. Berg/Chemineer Inc.
  13.      
  14.      
  15.                                    Disclaimer
  16.      
  17.         This software has been released to the public domain by the author.
  18.      All commercial rights are retained by the author.  It may be freely
  19.      passed on to others as long as no charge is made except for possibly a
  20.      small copying charge.  Although this software is thought to work as
  21.      described, no warranty of fitness is made for this software.
  22.      
  23.      
  24.      
  25.         CWEEP is a program to provide the same capabilities for the MS-DOS
  26.      user as the program SWEEP does for the CP/M user.  It provides the
  27.      ability to take a sorted list of the files on a disk and move forward
  28.      and backward in the list.  Files can be viewed, copied, deleted
  29.      individually and in groups.
  30.      
  31.         CWEEP is invoked at the MS-DOS command line by:
  32.      
  33.                     CWEEP {d:}{path}{afn} {-sw} {-sw}
  34.      
  35.           {d:}      an optional drive letter, the default being the
  36.                     currently logged drive
  37.      
  38.           {path}    an optional path.  Valid only for the 2.x version.
  39.      
  40.           {afn}     an optional ambiguous filename of what files to look
  41.                     at, the default begin "*.*" (in the currently logged
  42.                     directory under DOS 2.x).
  43.      
  44.           {-sw}     an optional switch or switches.  Switches begin with a
  45.                     '-' character.
  46.      
  47.         CWEEP will then look up all files matching the specified files, and
  48.      prompt with the first file name.  At this point, commands can be
  49.      entered to move around in the list, tag files, copy files, etc.  The
  50.      display on the next page was generated by starting CWEEP with no
  51.      filename specified:
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                                      Page 1
  61.  
  62.  
  63.                     CWEEP - A SWEEP-like program for MS-DOS
  64.  
  65.  
  66.           CWEEP                    (Display for version 1.x)
  67.      
  68.                                  CWEEP version 1.37
  69.                  Copyright (C) 1985 by: Gary M. Berg/Chemineer Inc.
  70.      
  71.               sp/cr Advance to next file      [M]  Mass copy tagged files
  72.                [A]  Re-tag '#' marked files   [N]  Calculate CRC
  73.                [B]  Back up one file          [P]  Protected mass copy
  74.                [C]  Copy file to drive        [R]  Rename a file
  75.                [D]  Delete a file             [S]  Sort directory
  76.                [E]  Erase (un)tagged files    [T]  Tag a file
  77.                [F]  Free space on a drive     [U]  Untag a file
  78.                [H]  Hexidecimal display       [V]  View file
  79.                [I]  Print size/time for file  [W]  Wildcard file tag
  80.                [J]  Jump to a named entry     [X]  Exit program
  81.                [L]  Log new drive/filename    [Z]  Change subdirectory
  82.              [?],[/]Print this message        [=]  Goto settings menu
  83.      
  84.              [-?], [+?] List other help messages, [@] for printer
  85.      
  86.              47 files, using 226089 bytes (245K)  -- 19968 bytes free (20K)
  87.      
  88.        1. I:CW-COPY .C   08-Feb-1985     7K :[X] eXit
  89.      
  90.      
  91.      or
  92.      
  93.           CWEEP                    (Display for 2.x version)
  94.      
  95.                                  CWEEP version 2.14
  96.                  Copyright (C) 1985 by: Gary M. Berg/Chemineer Inc.
  97.      
  98.               sp/cr Advance to next file      [M]  Mass copy tagged files
  99.                [A]  Re-tag '#' marked files   [N]  Calculate CRC
  100.                [B]  Back up one file          [P]  Protected mass copy
  101.                [C]  Copy file to drive        [R]  Rename a file
  102.                [D]  Delete a file             [S]  Sort directory
  103.                [E]  Erase (un)tagged files    [T]  Tag a file
  104.                [F]  Free space on a drive     [U]  Untag a file
  105.                [H]  Hexidecimal display       [V]  View file
  106.                [I]  Print size/time for file  [W]  Wildcard file tag
  107.                [J]  Jump to a named entry     [X]  Exit program
  108.                [L]  Log new drive/filename    [Z]  Change subdirectory
  109.              [?],[/]Print this message        [=]  Goto settings menu
  110.      
  111.              [-?], [+?] List other help messages, [@] for printer
  112.      
  113.              48 files, using 227027 bytes (246K)  -- 18944 bytes free (19K)
  114.      
  115.        1. I:CW-COPY .C   08-Feb-1985     7K :[X] eXit
  116.  
  117.  
  118.  
  119.  
  120.                                      Page 2
  121.  
  122.  
  123.                     CWEEP - A SWEEP-like program for MS-DOS
  124.  
  125.  
  126.         The files matching what was specified (in this case *.*) are sorted
  127.      in alphabetic order, and the first file in the list is listed on the
  128.      screen with the date and the size rounded up to the nearest 1K.  In
  129.      addition, the amount of space free and the amount of space used in the
  130.      selected files is displayed.
  131.      
  132.         The following is a list of commands with a short explanation:
  133.      
  134.           [@]       This character may be prefixed to a command to cause
  135.                     the output of the command to also go to the printer.
  136.                     This works with the [?] help, [H]ex, [N] CRC, [Q]uery,
  137.                     and [V]iew commands.  If the command is a "paged"
  138.                     display, form-feeds will automatically be added to the
  139.                     printer output every 60 lines.
  140.      
  141.           <sp>
  142.           <cr>      Advance to the next file on the list.  Go to the first
  143.                     file on the list if you are at the last file on the
  144.                     list.
  145.      
  146.           [A]       Re-tag all files which are marked with a "#" in the
  147.                     list.
  148.      
  149.           <bs>
  150.           [B]       Back up to the previous file in the list.  Go to the
  151.                     last file in the list if B is entered when you are
  152.                     waiting at the first file on the list.
  153.      
  154.           [C]       Copy this file to another drive.  Prompt for the drive
  155.                     to copy to.  Destination drive can be entered in the
  156.                     form "d[:[v]]".  The if the "v" is specified, then the
  157.                     copy will be verified.  If the file already exists, the
  158.                     user will be queried about whether to delete it or not.
  159.                     In version 2.x, the destination may be given as a
  160.                     subdirectory.  The default drive will be the current
  161.                     one.
  162.      
  163.                     "A"               - Copy to drive A
  164.                     "A:"              - Copy to drive A
  165.                     "B:V"             - Copy to drive B, and verify copy
  166.                     "B:\GARY:V"       - Copy to subdirectory "\GARY" on
  167.                                         drive B.  Verify the copy.
  168.                     "OTHER\SOME:V"    - Copy to subdirectory "OTHER\SOME"
  169.                                         on the logged drive.  Note that
  170.                                         this is a relative subdirectory,
  171.                                         relative to the current sub-
  172.                                         directory on the logged drive.
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.                                      Page 3
  181.  
  182.  
  183.                     CWEEP - A SWEEP-like program for MS-DOS
  184.  
  185.  
  186.           [-C]      Copy file to another file name.  Need to specify what
  187.                     the new drive and file name are.  Append a ":V" to the
  188.                     end of the new name if you want the copy verified.
  189.                     Specify the destination subdirectory if required with
  190.                     version 2.x.
  191.      
  192.           [D]       Delete file.  You are asked to verify deletion.
  193.      
  194.           [E]       Erase all tagged or untagged files.  User is prompted
  195.                     for which type of files to erase, and whether the user
  196.                     should be prompted about each file or not.  At most
  197.                     options an "A" will abort the operation.
  198.      
  199.           [F]       Check free space on any drive.
  200.      
  201.           [H]       Dump the file in hex format.  The escape and return
  202.                     keys abort the dump, any other key pauses it.
  203.      
  204.           [-H]      Dump the file in hex one 'page' at a time.
  205.      
  206.           [I]       Display the file size in bytes and the creation time.
  207.      
  208.           [J]       Jump to the file in the list.  Specify name and
  209.                     extension, it will jump to the closest point in the
  210.                     list.
  211.      
  212.           [L]       Log in a new drive (directory on V2.x) and ambiguous
  213.                     filename.  Will replace the list currently being used
  214.                     by one matching what was entered.  If no period (".")
  215.                     is in the string, a "*.*" will be appended to the
  216.                     string for the ambiguous filename.
  217.      
  218.           [M]       Copy all files which have been tagged to a specified
  219.                     drive.  The syntax is the same as for the Copy option.
  220.                     This option WILL delete (without warning) any files
  221.                     existing on the destination if they match a file which
  222.                     is being copied.
  223.      
  224.           [N]       Calculate a CRC for this file.  This is the same CRC as
  225.                     the CP/M program CRCK returns.
  226.      
  227.           [-N]      Calculate CRC's for all tagged files.
  228.      
  229.           [+N]      Calculate CRC's for all untagged files.
  230.      
  231.           [-O]      Output a list of all tagged files to a disk file.
  232.      
  233.           [+O]      Output a list of all untagged files to a disk file.
  234.      
  235.           [P]       Protected mass copy option.  Same as "M" option except
  236.                     that the user will be queried before existing files are
  237.                     deleted.
  238.  
  239.  
  240.                                      Page 4
  241.  
  242.  
  243.                     CWEEP - A SWEEP-like program for MS-DOS
  244.  
  245.  
  246.           [-Q]      Display a list of tagged files.
  247.      
  248.           [+Q]      Display a list of untagged files.
  249.      
  250.           [R]       Rename the file to something else.  A wildcard new name
  251.                     is allowed.  If just "*" is entered, a wild card may be
  252.                     entered for the old and new names.
  253.      
  254.           [S]       Sort the directory in order by name, extension, date,
  255.                     or size.  Preceed the sort field by "-" to invert the
  256.                     normal order.
  257.      
  258.           [T]       Tag a file.  It will appear in the listing marked with
  259.                     a "*", and will be used in any operations which work on
  260.                     tagged files.
  261.      
  262.           [U]       Untag a file.  Clears the "*" marker.
  263.      
  264.           [V]       Display the file.  It ignores line feeds, and converts
  265.                     returns and vertical tabs to return/linefeed.  This
  266.                     allows listing files created by programs which only put
  267.                     returns in the file, such as Spellbinder.  The listing
  268.                     can be controlled by using return or escape to
  269.                     terminate, and any other key to pause.
  270.      
  271.           [-V]      Display file one 'page' at a time.
  272.      
  273.           [W]       Tag all files matching a wildcard.
  274.      
  275.           [-W]      Tag all files not matching a wildcard.
  276.      
  277.           [Z]       Enter a CHDIR command.  Only valid for MS-DOS versions
  278.                     2.0 and higher.
  279.      
  280.           [?]
  281.           [/]       Print help text for all commands with no "+" or "-"
  282.                     prefix.
  283.      
  284.           [-?]
  285.           [-/]      Print help text for all commands with a "-" prefix.
  286.      
  287.           [+?]
  288.           [+/]      Print help text for all commands with a "+" prefix.
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.                                      Page 5
  301.  
  302.  
  303.                     CWEEP - A SWEEP-like program for MS-DOS
  304.  
  305.  
  306.           [=]       This will take you to a settings menu controlling
  307.                     several program flags.  These are:
  308.      
  309.                     [M]  Turn the menu printing on/off.  Turning it off
  310.                          will suppress printing the menu when logging a new
  311.                          file specification.  Same as the command line
  312.                          option "-?" or "-/".
  313.      
  314.                     [P]  Turn the path display on/off (V2.x only).
  315.      
  316.                     [Z]  Turn ctrl/Z processing on/off.  When on, viewing a
  317.                          file will stop on ctrl/Z.  When off, ctrl/Z is not
  318.                          considered an end of file.
  319.      
  320.                     [=]
  321.                     [Q]
  322.                     [X]  Exit the settings menu and return to normal
  323.                          operations.
  324.      
  325.                     [?]
  326.                     [/]  Print a help message.
  327.      
  328.      
  329.      
  330.                              COMMAND LINE SWITCHES
  331.      
  332.      The following is a list of valid command line switches for CWEEP.
  333.      They may follow or preceed the file specification to be logged in.
  334.      
  335.           [-?]
  336.           [-/]      Toggle the main help menus off.  If present, the main
  337.                     help menus will only be displayed when requested.  This
  338.                     setting may be altered from the mini-menu.
  339.      
  340.           [-p]      Toggle the display of the logged path off.
  341.      
  342.           [-z]      Toggle control/Z processing.  If present on the command
  343.                     line, control/Z will be ignored when encountered in a
  344.                     file being viewed.  This setting may be altered from
  345.                     the mini-menu.
  346.      
  347.           [-d]
  348.           [-e]
  349.           [-n]
  350.           [-s]      Set the initial sort order to ascending whatever.  The
  351.                     options are the same as in the [S] command.  If the
  352.                     switch is entered as [--x] then the order will be
  353.                     descending (i.e., [--d] will sort by descending date,
  354.                     or most recent first).
  355.  
  356.  
  357.  
  358.  
  359.  
  360.                                      Page 6
  361.  
  362.  
  363.                     CWEEP - A SWEEP-like program for MS-DOS
  364.  
  365.  
  366.         For the user who does not like the default settings of some of the
  367.      command-line switches in CWEEP (not for the faint of heart), it is
  368.      possible to patch the values with DEBUG.  If you unassemble the
  369.      beginning of the code, you will find several move word and move byte
  370.      instructions.  By changing the value moved to 1 (true) or 0 (false)
  371.      the default may be changed (note that sort-order is an ascii
  372.      character).  The move commands are (in order):
  373.      
  374.           1)
  375.                Console on          (Please don't change this!!)
  376.           2)
  377.                Printer off         (Please don't change this!!)
  378.           3)
  379.                Menu on             (The "M" in the settings menu)
  380.           4)
  381.                Initial sort order  (Lower case is ascending)
  382.                                    (Upper case is descending)
  383.           5)
  384.                Ctrl/Z on           (The "Z" in the settings menu)
  385.           6)
  386.                Path display on     (The "P" in the settings menu)
  387.      
  388.      
  389.         CWEEP is written in the C language, and compiled with the C-ware
  390.      DeSmet C compiler.  A Zenith Z-100 was used to develop it.  It has
  391.      been tested by myself or others on a Z-150, IBM PC, and a Wang PC.  It
  392.      uses some custom routines for reading and writing files and handling
  393.      all I/O to the keyboard and printer.
  394.      
  395.         Since CWEEP uses the MS-DOS bdos calls to read/write the keyboard,
  396.      commands such as Ctrl/P and Ctrl/N work for directing output to the
  397.      printer.  This allows the user to obtain a hardcopy listing of a
  398.      session with CWEEP.  I/O redirection in MS-DOS version 2.0 and higher
  399.      allows putting a copy of a session in a file.  However, the output
  400.      would not be displayed on the screen, making it difficult to use.  In
  401.      addition, input redirection may be used if you can figure out exactly
  402.      what the input should be.
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.                                      Page 7
  421.