home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / util4 / clnout13.lzh / CLEANOUT.DOC next >
Text File  |  1989-12-25  |  38KB  |  1,094 lines

  1.  
  2.  
  3.                   CLEANOUT
  4.  
  5.  
  6.  
  7.                   Selective File Deletion Utility
  8.  
  9.  
  10.  
  11.                   Version  1.3
  12.                   Released 12-10-89
  13.  
  14.  
  15.  
  16.  
  17.                   Herron Software
  18.                   P.O. Box 1288
  19.                   Battle Ground, Washington  98604
  20.  
  21.  
  22.  
  23.  
  24.          COPYRIGHT 1988, 1989 Phil Herron.  ALL RIGHTS RESERVED.
  25.  
  26.  
  27.                   DISCLAIMER OF WARRANTY
  28.          __________________________________________
  29.  
  30.  
  31.  
  32.          THIS PRODUCT IS PROVIDED FOR EVALUATION, AS IS
  33.          AND WITHOUT WARRANTY OF ANY KIND.  THE AUTHOR
  34.          MAKES NO EXPRESS OR IMPLIED WARRANTIES,
  35.          INCLUDING BUT NOT LIMITED TO MERCHANTABILITY
  36.          OR FITNESS FOR ANY PURPOSE.  IN NO EVENT SHALL
  37.          THE AUTHOR BE LIABLE FOR LOSS OF PROFIT OR ANY
  38.          OTHER COMMERCIAL DAMAGE ARISING FROM EITHER
  39.          THE USE OF OR THE INABILITY TO USE THIS PRODUCT.
  40.  
  41.  
  42.  
  43.          This product should be thoroughly evaluated
  44.          using backed up or noncritical data and files.
  45.  
  46.  
  47.  
  48.  
  49.    ______________________________________________________________
  50.  
  51.    Evaluation Preface                                     Section
  52.    ______________________________________________________________
  53.  
  54.    Shareware............................................... 0.1.0
  55.      What it is............................................ 0.1.1
  56.      License Terms......................................... 0.1.2
  57.      Registration.......................................... 0.1.3
  58.        Benefits, Forms, Registration fees,
  59.        Quantity discounts, Combined orders
  60.  
  61.    Evaluation.............................................. 0.2.0
  62.      Evaluation Version.................................... 0.2.1
  63.      Evaluation Menu....................................... 0.2.2
  64.      Virus Prevention...................................... 0.2.3
  65.  
  66.  
  67.  
  68.    _____________________________
  69.  
  70.    0.1.0          Shareware
  71.    _____________________________
  72.  
  73.  
  74.  
  75.    0.1.1   The SHAREWARE Concept
  76.    _____________________________
  77.  
  78.    "Shareware" is a software distribution method which enables
  79.    the potential user to obtain software at very low initial
  80.    cost, for evaluation on a trial basis.
  81.  
  82.    You can evaluate the software in your own environment, on your
  83.    own machine, with the programs and data that you normally use.
  84.    You're not required to become a registered user unless the
  85.    software meets your needs.
  86.  
  87.    Another benefit of Shareware is lower pricing.  By minimizing
  88.    the marketing and advertising expenses associated with more
  89.    traditional software distribution methods, Shareware products
  90.    can be priced lower.  You don't pay for what you don't need or
  91.    use.
  92.  
  93.    You are encouraged to share the evaluation version of this
  94.    software with others, so long as you follow the limitations
  95.    set forth in the LICENSE TERMS section below.
  96.  
  97.  
  98.    0.1.2   LICENSE TERMS
  99.    _____________________
  100.  
  101.    This product and its documentation are copyrighted and owned
  102.    solely by the author, who reserves all rights to any benefits
  103.    derived from it.  It is distinctly separate from, and should
  104.    not be confused with, those categories of software known as
  105.    "public domain" or "freeware."
  106.  
  107.    You are granted the right to use the evaluation version of
  108.    this software on a trial basis for a limited amount of time,
  109.    to decide whether to continue using (and therefore whether
  110.    to register) the product.
  111.  
  112.    You can transmit this evaluation version to associates by
  113.    copying on diskette or uploading to electronic bulletin board
  114.    services, so long as the following CONDITIONS are met:
  115.  
  116.      (a) The program and its documentation file must be
  117.          distributed together.
  118.  
  119.      (b) The program and its documentation must not be
  120.          altered in any way.  If you wish to include
  121.          notes for other evaluators, please add them in
  122.          a separate file and include that file along
  123.          with the program and documentation files.
  124.  
  125.  
  126.    0.1.3   REGISTRATION
  127.    ____________________
  128.  
  129.    When you send in the registration form and fee, you'll
  130.    receive by return mail a diskette containing the latest
  131.    REGISTERED version of the program and documentation.
  132.  
  133.  
  134.    BENEFITS OF REGISTRATION
  135.  
  136.      The registered version WILL NOT include the Evaluation Menu
  137.      front-end, startup time-delay or forms-printing sections of
  138.      this version.  Thus it will be more convenient to use, from
  139.      either the DOS prompt or from batch files.  It will also be
  140.      12k-15K bytes smaller, for more efficient disk storage and
  141.      faster loading.
  142.  
  143.      The registered version WILL include any new functions
  144.      or enhancements made to date.
  145.  
  146.      You will receive notification of future updates and
  147.      new products.
  148.  
  149.      You will be able to upgrade to newer versions at a
  150.      reduced cost.
  151.  
  152.  
  153.    REGISTRATION FORM
  154.  
  155.      The registration form and a pre-addressed mailing cover
  156.      can be printed from the "Forms Printing" selection of
  157.      the Evaluation menu, discussed in section 0.2.2 below.
  158.  
  159.  
  160.    FEES
  161.  
  162.      The single-quantity registration fee is displayed on the
  163.      initial Evaluation Menu screen.  Higher quantities are
  164.      discussed below.
  165.  
  166.  
  167.    QUANTITY DISCOUNTS
  168.  
  169.      Each registered copy of this software will be licensed for
  170.      operation at a single location (on a single terminal or
  171.      computer) at any one time.  If you need to run the software
  172.      on more than one terminal or computer at the same time, the
  173.      appropriate number of registrations must be made.
  174.  
  175.      Multiple-quantity registration fees are displayed in the
  176.      "QUANTITY DISCOUNT" section of the Evaluation menu.
  177.  
  178.      You can take advantage of quantity discounts by ordering
  179.      multiple registrations of one program or single
  180.      registrations of several different programs at the same
  181.      time.  You also save on shipping and handling charges
  182.      by registering several products together.
  183.  
  184.  
  185.    COMBINED ORDERS
  186.  
  187.      You can also take advantage of quantity discounts by
  188.      combining orders with associates:
  189.  
  190.      (1)   Complete a separate registration form for each person.
  191.               Each person's name, address and programs to be
  192.               registered are needed for support and update
  193.               notification purposes.
  194.  
  195.      (2)   Include only one standard shipping and handling charge.
  196.               Cross out the "Shipping & handling" amounts on
  197.               all but ONE registration form; the combined
  198.               order will be sent to the name and address on
  199.               that form.
  200.  
  201.      (3)   Mail all the forms together, with a single check/money
  202.               order for the total, in one envelope/mailing cover.
  203.  
  204.  
  205.  
  206.    _____________________________
  207.  
  208.    0.2.0          Evaluation
  209.    _____________________________
  210.  
  211.  
  212.  
  213.    0.2.1   EVALUATION VERSION
  214.    __________________________
  215.  
  216.    This software contains the complete and fully functional version
  217.    of the program, the latest available at the time of this release.
  218.  
  219.    The program itself is identical to the REGISTERED version.
  220.    An Evaluation Menu and forms-printing section were added
  221.    to ensure that:
  222.  
  223.      (a)   Registration information and forms will not
  224.            become separated from the program file.
  225.  
  226.      (b)   Users who might be unfamiliar with the process
  227.            of displaying a file's contents on the screen or
  228.            printer will have no difficulty learning about,
  229.            evaluating or registering this product.
  230.  
  231.  
  232.    0.2.2   EVALUATION MENU
  233.    _______________________
  234.  
  235.    The program is invoked from the DOS prompt by typing its name
  236.    and pressing the RETURN or ENTER key.
  237.  
  238.    The initial screen displays the warranty section and some
  239.    information about the program:
  240.  
  241.      Program name,
  242.      Version number,
  243.      Release date,
  244.      Single-quantity registration fee.
  245.  
  246.    It next displays the Shareware Product EVALUATION MENU.
  247.    A single key press will select the following functions
  248.    from the menu:
  249.  
  250.      ESC - EXIT to DOS without evaluating this program
  251.       R  - READ the documentation (THIS file)
  252.       x  - EVALUATE this program
  253.       Q  - QUANTITY Discount information
  254.       F  - FORMS printing menu - registration & mailer
  255.  
  256.    When you press "R" to READ the documentation, this file will
  257.    be shown one screen at a time.  The display pauses whenever the
  258.    screen becomes full, and prompts...
  259.  
  260.                      <downArrow> or Esc
  261.  
  262.    The <downArrow> character is similar to the "MORE" prompt in
  263.    other DOS utilities.  It indicates that more is available.
  264.    Press ESCape to exit back to the Evaluation Menu, or any normal
  265.    typing key to continue (space bar is a convenient key to use).
  266.  
  267.  
  268.    0.2.3   VIRUS PREVENTION
  269.    ________________________
  270.  
  271.    If you'd like to evaluate this software but you're not sure
  272.    where it's been, you can order a copy straight from the source.
  273.    See the SHAREWARE PRODUCT CATALOG section at the end of this file.
  274.  
  275.  
  276.  
  277.    _________________________________________________________________
  278.  
  279.    Table of Contents                                         Section
  280.    _________________________________________________________________
  281.  
  282.    CleanOut................................................... 1.0
  283.       Introduction............................................ 1.1
  284.       Explanation............................................. 1.2
  285.       System Requirements..................................... 1.3
  286.          Installing........................................... 1.3.1
  287.       Help.................................................... 1.4
  288.       Syntax.................................................. 1.5
  289.          Wildcard Characters.................................. 1.5.1
  290.       Examples................................................ 1.6
  291.          CleanOut *.BAK with confirmation..................... 1.6.1
  292.          CleanOut *.BAK with NO confirmation.................. 1.6.2
  293.       File VIEWING............................................ 1.7
  294.       File Attributes......................................... 1.8
  295.       DOS ErrorLevel.......................................... 1.9
  296.       Application: LogOff batch file.......................... 2.0
  297.       Application: CleanOut across multiple drives............ 2.1
  298.       File Recovery........................................... 3.0
  299.       Future Additions.........................................4.0
  300.       Version History......................................... 5.0
  301.  
  302.    Support.................................................... 9.0
  303.       Problem Resolution...................................... 9.1
  304.       Before Reporting........................................ 9.2
  305.       Reporting a problem..................................... 9.3
  306.       Custom Modifications.................................... 9.4
  307.       Correspondence.......................................... 9.5
  308.  
  309.    Shareware Product Catalog................................. 10.0
  310.  
  311.  
  312.  
  313.  
  314.    ******************************************
  315.             NEW in this version
  316.    ******************************************
  317.  
  318.    *** Color support ***
  319.  
  320.      Previous versions employed white text on black background
  321.      exclusively; this version uses the default colors in effect
  322.      when the program is started.
  323.  
  324.    *** File VIEWING facility ***
  325.  
  326.      In "confirmation" mode, CLEANOUT displays the name of
  327.      each file found, then waits for you to save or delete it.
  328.      If you're not sure what it contains, you can now select
  329.      the file VIEWING facility to display part or all of the
  330.      file's contents.  See sections 1.6.1 and 1.7 for further
  331.      explanation.
  332.  
  333.    *** Nested Subdirectories ***
  334.  
  335.      CLEANOUT can now handle subdirectories nested up to
  336.      sixteen deep, just in case any exist; prior versions
  337.      worked only to a depth of twelve.
  338.  
  339.  
  340.  
  341.  
  342. ______________________________________________________________
  343.  
  344.                CLEANOUT
  345. 1.0
  346.                Selective File Deletion Utility
  347. ______________________________________________________________
  348.  
  349.  
  350.  
  351.  
  352. 1.1   INTRODUCTION
  353. __________________
  354.  
  355.    You've been pounding the keys for hours; the word processor,
  356.    the spreadsheet and the occasional pop-up note pad have left
  357.    a long trail of
  358.                         #@*$^%&!.BAK
  359.  
  360.    files strewn across the tree-structured landscape of your disk.
  361.  
  362.  
  363.    Your mind has fogged in; you need to delete some of those
  364.    backup files to recover storage space, but you're having
  365.    difficulty focusing on the DOS commands that might help corner
  366.    them, let alone the names of the subdirectories where they're
  367.    hiding.  Do you look in every subdirectory, or in just the ones
  368.    you can still name?  #@*$^%&!.
  369.  
  370.  
  371.    Repeat the phrase, "I'm going to CLEANOUT this mess!"
  372.    until it finally registers:
  373.  
  374.                         CLEANOUT
  375.  
  376.    will preserve your sanity for more important things,
  377.    like recalling where you left your car keys.
  378.  
  379.  
  380.  
  381.  
  382. 1.2   EXPLANATION
  383. _________________
  384.  
  385.    CLEANOUT searches the root and all subdirectories of the
  386.    current drive for ordinary and archive files matching the
  387.    input filename and extension; wildcard characters
  388.    * and ? can be used.
  389.  
  390.    In the default CONFIRMATION mode (without /N on the command line),
  391.    CLEANOUT displays each matching file when found, then prompts for
  392.    user action:
  393.  
  394.          _Delete  _View  _Save  _ESC-save & exit
  395.  
  396.  
  397.  
  398.  
  399. 1.3     SYSTEM REQUIREMENTS
  400. ___________________________
  401.  
  402.    PC, XT, AT or compatible.
  403.    DOS version 2.1 or later.
  404.    64K free memory.
  405.  
  406.  
  407.  
  408.  
  409. 1.3.1   INSTALLING
  410. __________________
  411.  
  412.    The program can be run from diskette or from hard disk.
  413.    No installation is necessary, other than copying the
  414.    files to a drive and directory of your choosing.
  415.  
  416.  
  417.  
  418.  
  419. 1.4   HELP
  420. __________
  421.  
  422.    Can't remember the command line syntax?
  423.    Issue the program's name without any parameters; it
  424.    will display a help screen, then return to the DOS prompt.
  425.  
  426.  
  427.  
  428.  
  429. 1.5   SYNTAX
  430. ____________
  431.  
  432.                                  No confirmation
  433.                                  /
  434.       CleanOut [filename.ext] [/N]
  435.  
  436.  
  437.  
  438.  
  439. 1.5.1   WILDCARD CHARACTERS
  440. ___________________________
  441.  
  442.    Wildcard characters * and ? are legal for use in specifying
  443.    filenames and extensions.
  444.  
  445.    Certain combinations are trapped and not allowed; these specific
  446.    combinations are interpreted by DOS to mean "ALL files":
  447.  
  448.  
  449.          *           .                .*            *.*
  450.  
  451.  
  452.          *.???       .???     ????????.*     ????????.???
  453.  
  454.        ________________________________________________________
  455.       |                                                        |
  456.       |  - WARNING - WARNING - WARNING - WARNING - WARNING -   |
  457.       |________________________________________________________|
  458.       |                                                        |
  459.       |   There may be MORE combinations that specify "ALL     |
  460.       |   files"; the list above covers ONLY the ones trapped  |
  461.       |   by CLEANOUT.                                         |
  462.       |                                                        |
  463.       |   For experiments, use the default CONFIRMATION mode.  |
  464.       |________________________________________________________|
  465.  
  466.  
  467.    When used with extensions of .* or .???, filenames containing
  468.    EIGHT question marks are disallowed, but those containing SEVEN
  469.    or FEWER are allowed, since they specify valid filenames that
  470.    are not "ALL files".
  471.  
  472.    Similarly, when used with filenames of * or ???????? (eight
  473.    question marks), extensions containing THREE question marks
  474.    are disallowed, but those containing TWO or ONE are allowed,
  475.    since they specify valid extensions that are not "ALL files."
  476.  
  477.  
  478.  
  479.  
  480. 1.6   EXAMPLES
  481. ______________
  482.  
  483.       CleanOut *.bak      (finds and prompts for deletion of
  484.                            all .BAK files on current drive)
  485.  
  486.  
  487.  
  488.  
  489. 1.6.1   OPERATING SCREEN with CONFIRMATION (default mode)
  490. _________________________________________________________
  491.  
  492.    The operating screen appears whenever "CLEANOUT" is issued from
  493.    the DOS prompt (or from a batch file) with a file specification;
  494.    in this example, the complete command line is:
  495.  
  496.             CleanOut *.bak
  497.  
  498.    and the screen displays:
  499.  
  500.     __CleanOut____________________
  501.    |______________________________|
  502.  
  503.    CleanOut  *.BAK  on drive C:
  504.                 \             \
  505.                  \             \
  506.                filespec      current drive
  507.  
  508.  
  509.  
  510.    The screen next displays the drive letter and subdirectory
  511.    currently being searched, until a file is found that matches
  512.    the input file specification.  The search can be exited at any
  513.    time by pressing the ESCAPE key.  Upon finding a file, the
  514.    screen displays:
  515.  
  516.          C:\(ROOT directory)
  517.             MYFILE  .BAK   471842  10-01-89  20:57
  518.  
  519.  
  520.    At this point the cursor is placed to the right of the file
  521.    information, and you are prompted for confirmation in a
  522.    highlighted bar at the bottom of the screen:
  523.  
  524.       _Delete  _View  _Save  _ESC-save & exit
  525.  
  526.    Selections:
  527.       D   -  Delete file, then continue searching.
  528.       V   -  View contents of file (see section 1.7 below).
  529.       S   -  Save file, continue searching.
  530.       ESC -  Save file, exit CleanOut.
  531.  
  532.       Note - The "D" key must be pressed twice to delete a file;
  533.              the first press presents a new prompt:
  534.  
  535.                 _Delete  _ESCape delete
  536.  
  537.              Press "D" to delete the file, or
  538.                    "ESC" to return to the previous prompt.
  539.  
  540.  
  541.    The above process is repeated until all subdirectories on the
  542.    drive have been checked and no more matching files are found.
  543.  
  544.  
  545.    A SUMMARY line then reports the number of matching files found,
  546.    the number deleted, and the disk storage space recovered:
  547.  
  548.             Found 1 file in 1 directory;  1 deleted.
  549.             475,136 bytes recovered.
  550.  
  551.    The "bytes recovered" specification is not merely the total of
  552.    the sizes of the deleted files, but the actual disk space freed
  553.    up by their deletion (freed clusters multiplied by the bytes-
  554.    per-cluster spec of the current drive).
  555.  
  556.  
  557.  
  558.  
  559. 1.6.2   OPERATING SCREEN with NO confirmation
  560. _____________________________________________
  561.  
  562.    In this example, the complete command line is
  563.  
  564.          CleanOut *.bak /N
  565.                           \
  566.                            (NO confirmation)
  567.  
  568.    and the screen displays:
  569.  
  570.     __CleanOut____________________
  571.    |______________________________|
  572.  
  573.    CleanOut  *.BAK  on drive C:        - NO CONFIRMATION -
  574.    C:\
  575.    C:\subdir1\
  576.    C:\subdir2\
  577.    .
  578.    .
  579.  
  580.    The screen displays only a list of the drive letter and
  581.    subdirectory currently being searched.  As each file matching
  582.    your input filespec is found, it is IMMEDIATELY DELETED without
  583.    pausing for confirmation.
  584.  
  585.    If you decide not to continue, you can terminate CLEANOUT by
  586.    pressing the ESCAPE key at any time, although by now some of the
  587.    files have probably already been deleted.  To avoid this in the
  588.    future you may want to use CLEANOUT's default CONFIRMATION mode,
  589.    previously described, whenever you're not completely sure about
  590.    which files to delete.
  591.  
  592.  
  593.  
  594.  
  595. 1.7   FILE VIEWING
  596. __________________
  597.  
  598.    The file viewing facility is available only in CONFIRMATION mode.
  599.    To handle both text and binary files, file contents are processed
  600.    one character at a time, rather than line-by-line.
  601.  
  602.    After a file is found and the prompt is displayed as described in
  603.    section 1.6.1, the "V" key activates the file viewing window.  The
  604.    window's top line contains drive letter, path and filename of the
  605.    file being viewed; its bottom line displays a prompt:
  606.  
  607.       V-view more  D-delete  S-save  ESC-exit.
  608.  
  609.    Selections:
  610.       V   -  View next screen.  <SpaceBar>, <DownArrow>,
  611.              <PgDn> or <Return> can also be used.
  612.       D   -  Delete file, then continue searching.
  613.       S   -  Save file, continue searching.
  614.       ESC -  Terminate viewing before end of file;
  615.              return to main screen.
  616.  
  617.       Note - The "D" key must be pressed twice to delete a file;
  618.              the first press presents a new prompt:
  619.  
  620.                 _Delete  _ESCape delete
  621.  
  622.              Press "D" to delete the file, or
  623.                    "ESC" to return to the previous prompt.
  624.  
  625.  
  626.  
  627.  
  628. 1.8   FILE ATTRIBUTES
  629. _____________________
  630.  
  631.    Cleanout will find and delete only those files with
  632.    attributes of ORDINARY or ARCHIVE.
  633.  
  634.    All files with other attributes are ignored:
  635.    ReadOnly, Hidden, System, Volume label, Directory.
  636.  
  637.  
  638.  
  639.  
  640. 1.9   DOS ERRORLEVEL
  641. ____________________
  642.  
  643.   Upon termination, the program returns a DOS ErrorLevel value
  644.   which indicates how the program ended, and which can be used for
  645.   subsequent operations in a batch file.  For further information,
  646.   see the "IF ERRORLEVEL" batch command in your DOS manual.
  647.  
  648.    ErrorLevel List:
  649.  
  650.       0  -  Successful completion.
  651.       1  -  No parameters specified on command line.
  652.       3  -  "ALL files" specified.
  653.      27  -  Early termination; ESCape key pressed.
  654.     254  -  Problem setting up viewing window.
  655.  
  656.    Example of ErrorLevel usage in a batch file:
  657.  
  658.        CLEANOUT *.bak
  659.        if errorlevel 1 goto END
  660.        :EL0
  661.          .
  662.          .
  663.        :END
  664.  
  665.     If CleanOut terminates normally with an errorlevel of 0, then
  666.     the section following the label :EL0 will run.  However, if it
  667.     returns an errorlevel of 1 OR GREATER (most likely caused by the
  668.     user pressing the ESC key to terminate early), then the :EL0
  669.     section will be skipped.
  670.  
  671.     For a working example, see the batch file in the second
  672.     following application section.
  673.  
  674.  
  675.  
  676.  
  677. 2.0   APPLICATION: LogOff batch file
  678. ____________________________________
  679.  
  680.    CLEANOUT can be called from a batch file.  If you have a logoff
  681.    batch file that performs such functions as writing the time
  682.    and date to a log file and parking the hard disk heads,
  683.    add the line
  684.  
  685.          CLEANOUT *.BAK /N
  686.  
  687.    to the batch file, prior to the point where it parks the
  688.    heads.  From then on all your BAK files will be cleaned out
  689.    automatically.
  690.  
  691.    Besides providing convenience, such batch file usage can be
  692.    safer than entering critical commands directly.  It is not
  693.    unheard of, after a long day, to enter "del *.baT" when you
  694.    meant "del *.baK".
  695.  
  696.  
  697.    If you have several hard disks, or one that is split into
  698.    several "logical" drives, add the following lines to your
  699.    logoff batch file (example assumes hard drives C and D)...
  700.  
  701.          C:                  (makes C: the currently logged drive)
  702.          CLEANOUT *.BAK /N
  703.          D:                  (makes D: the currently logged drive)
  704.          CLEANOUT *.BAK /N
  705.  
  706.  
  707.    BAK files are reason enough for using CLEANOUT, but it can also
  708.    be useful for deleting other files, whether or not related by
  709.    name/extension, since it searches all areas of a disk to find
  710.    them.
  711.  
  712.    Use caution if you have duplicate or overlapping filenames or
  713.    extensions in several subdirectories.  Remember, the invocation
  714.  
  715.             CLEANOUT *.ba?
  716.  
  717.    will find all files with extensions of .BAK, .BAT and .BAS,
  718.    anywhere on the disk.  Of course, in the default mode it asks
  719.    for confirmation before deleting any of them.
  720.  
  721.  
  722.  
  723.  
  724. 2.1   APPLICATION: CleanOut across multiple drives
  725. __________________________________________________
  726.  
  727.    Below is a batch file that can be used to delete specified files
  728.    from more than one drive.  The drive list can be easily changed to
  729.    handle any number of drives.  Note that the DOS path statement must
  730.    be properly set up before running this batch file (unless
  731.    CleanOut.Exe also exists on each drive to be handled).
  732.  
  733.       :::: ClOut.Bat -- handles drives A,B,C as written.
  734.       echo off
  735.       if "%1"=="" goto NoSPEC
  736.       A:
  737.       Cleanout %1
  738.       if errorlevel 1 goto END
  739.       B:
  740.       Cleanout %1
  741.       if errorlevel 1 goto END
  742.       C:
  743.       Cleanout %1
  744.       goto END
  745.       :NoSPEC
  746.       echo Syntax: %0 [filename.ext]  -  wildcards * and ? are legal.
  747.       echo   File cleanout with confirmation on drives A, B and C.
  748.       echo   Location of CleanOut.Exe must be included in a path
  749.       echo   statement.  Example: PATH=C:\UTIL
  750.       :END
  751.       C:
  752.  
  753.    Notes:
  754.       1 - There are several ways to convert the above listing
  755.           into batch file form.  One is to copy this entire file to
  756.           another named "ClnOut.Bat", delete everything except the
  757.           listing, then delete the leading spaces on the left side so
  758.           each line begins in column one.  Another is to display the
  759.           listing on screen, then use a memory-resident notepad to
  760.           "cut and paste" it into a batch file.
  761.  
  762.       2 - Single colons in the listing mark labels needed for
  763.           proper operation.  Multiple colons denote non-operational
  764.           comment lines which could be deleted.
  765.  
  766.  
  767.  
  768.  
  769. 3.0   FILE RECOVERY
  770. ___________________
  771.  
  772.    If you delete the wrong file...
  773.  
  774.    The file deletion method used by CLEANOUT is identical
  775.    to that used by the DOS "DELETE" and "ERASE" commands.
  776.  
  777.    Until overwritten by another file, an "erased" file still
  778.    exists on the disk, but with a modified disk directory entry
  779.    that designates it as "space available for use."  The next time
  780.    a file is saved to disk, the "erased" file may be overwritten.
  781.  
  782.    Recovery MAY be possible with a file "undelete" utility
  783.    (several Shareware versions are on the market) if you do so
  784.    PRIOR to saving any more files to that disk (thus overwriting
  785.    the contents of the "erased" file).
  786.  
  787.  
  788.    The BEST protection against losing files is to
  789.  
  790.       (1)   Make regular backup copies of critical files.
  791.  
  792.       (2)   Use CleanOut's default CONFIRMATION mode.
  793.  
  794.  
  795.  
  796.  
  797. 4.0   FUTURE ADDITIONS
  798. ______________________
  799.  
  800.    Some of your files may contain confidential information.  File
  801.    deletion or even disk reformatting does not guarantee that the
  802.    files can't be "undeleted".  For such files, a "wipe" function is
  803.    being explored; by overwriting the sensitive data before deleting,
  804.    it will ensure that the data is unrecoverable.
  805.  
  806.  
  807.  
  808.  
  809. 5.0   VERSION HISTORY
  810. _____________________
  811.  
  812.    1.00  Initial release.
  813.    1.01  Safety addition: error trapping of the most common DOS
  814.          wildcard "ALL files" combinations (*.*, ????????.???, etc.).
  815.    1.1   Safety addition: file deletion in CONFIRMATION mode
  816.          now requires TWO presses of the "D" key.
  817.    1.16  Coverage of nested subdirectories is extended
  818.          to a depth of sixteen.
  819.    1.2   Convenience addition: file viewing facility in CONFIRMATION
  820.          mode now allows checking file contents before saving or
  821.          deleting.
  822.    1.3   Display is no longer fixed white on black; now uses
  823.          default colors in effect when the program was started.
  824.  
  825.  
  826.  
  827.  
  828. _________________________________________________________________
  829.  
  830. 9.0            Support
  831. _________________________________________________________________
  832.  
  833.  
  834.  
  835.  
  836. 9.1   PROBLEM RESOLUTION
  837. ________________________
  838.  
  839.    Please document and report any anomaly in program operation,
  840.    whether it's a genuine "bug" or just some feature of the
  841.    program that particularly "bugs" you.
  842.  
  843.    If you're the first person to document and report a problem
  844.    that we agree needs attention, you'll receive a free upgrade
  845.    with the correction when it's been made.  If you're a
  846.    registered user, you'll get the upgraded registered version;
  847.    if you haven't yet registered, you'll get the upgraded
  848.    evaluation version.
  849.  
  850.  
  851.  
  852.  
  853. 9.2   BEFORE REPORTING
  854. ______________________
  855.  
  856.    Things to try prior to reporting a problem:
  857.  
  858.       1 - Reread the documentation to make sure you understand
  859.           what we thought we understood when we wrote it.
  860.  
  861.       2 - If the system reports "Bad command or file name" when
  862.           you attempt to run the program, its executable file
  863.           (or at least the file name you specified) was not found.
  864.  
  865.           First, make sure no typos or misspellings have crept
  866.           into your command line; next, try changing your PATH
  867.           setting, or make the drive & directory where the program
  868.           resides the "current" drive & directory.
  869.  
  870.       3 - If the program is being run from a batch file, try
  871.           deleting lines previous to the line that actually
  872.           invokes the program, to see if some prior activity
  873.           is causing the problem.
  874.  
  875.       4 - If you have any memory-resident or "TSR" utilities
  876.           installed (pop-up calculators/note pads, keyboard
  877.           enhancements, etc.), try removing them from memory
  878.           and running the program again to see if the problem
  879.           reoccurs.
  880.  
  881.  
  882.  
  883.  
  884. 9.3   REPORTING A PROBLEM
  885. _________________________
  886.  
  887.    If the problem persists, please document it as completely and
  888.    accurately as possible; we have to be able to duplicate it
  889.    before we can begin to resolve it.
  890.  
  891.    Include at least the following:
  892.  
  893.       1 - Version of DOS you are using.
  894.       2 - Machine type, drives, memory, etc.
  895.       3 - Programs executed prior to the problem.
  896.       4 - Problem program's name and version number.
  897.       5 - Where and how you obtained the problem program.
  898.       6 - Address and/or phone number where you can be contacted.
  899.       7 - Anything you can think of that might relate to the problem;
  900.           for example, listings of your AUTOEXEC.BAT and CONFIG.SYS
  901.           files, or any batch files used to run the program.
  902.       8 - Any relevant printouts.
  903.  
  904.  
  905.    NOTE: If you're a registered user, you'll find the utility
  906.          UserResp.Exe on the distribution diskette; it can be used
  907.          to print a pre-addressed mailer and a problem report.
  908.  
  909.          If you have not yet registered, send problem reports to the
  910.          address below (or print the pre-addressed mailer from the
  911.          Evaluation Menu).
  912.  
  913.  
  914.  
  915.  
  916. 9.4   CUSTOM MODIFICATIONS
  917. __________________________
  918.  
  919.    If you need custom modifications to this software for your
  920.    particular application, please write to the below address
  921.    with complete details of your requirements.
  922.  
  923.  
  924.  
  925.  
  926. 9.5   CORRESPONDENCE
  927. ____________________
  928.  
  929.    We welcome any comments or suggestions you might have
  930.    concerning improvements and future enhancements to this
  931.    product.  Send all correspondence and orders to:
  932.  
  933.              Phil Herron
  934.              P.O. Box 1288
  935.              Battle Ground, Washington  USA  98604
  936.  
  937.  
  938.  
  939.  
  940. _________________________________________________________________
  941.  
  942. 10.0           Shareware Product Catalog
  943. _________________________________________________________________
  944.  
  945.  
  946.   This section contains a list of our other Shareware products;
  947.   it may be updated whenever products are added or changed.
  948.           ____________________________________________
  949.  
  950.   If you'd like to try any of the programs in this catalog, but
  951.   can't find them locally, you can order evaluation copies
  952.   straight from the source...
  953.  
  954.   Five programs and their associated documentation will fit on each
  955.   5.25 inch 362Kb diskette; the basic single-disk fee of $4.00
  956.   covers the cost of the first disk, shipping and handling.  Add an
  957.   additional dollar for each additional disk of programs you want to
  958.   evaluate ($4.00 for 1 to 5 programs, $5.00 for 6-10, $6.00 for
  959.   11-15, etc.; all payments in U.S. funds).  If your address is
  960.   outside the U.S. and Canada, add an additional $3.00.
  961.  
  962.   Include your mailing address and the names of the programs.  By
  963.   return mail you'll receive the latest versions of those programs
  964.   for evaluation.
  965.           ____________________________________________
  966.  
  967.   "Shareware" is a software distribution method which enables the
  968.   potential user to obtain software at very low initial cost, for
  969.   evaluation on a trial basis.  You can evaluate the software in your
  970.   own environment, on your own machine, with the programs and data
  971.   that you normally use.  You're not required to become a registered
  972.   user unless the software meets your needs.
  973.           ____________________________________________
  974.  
  975.           PROGRAM SPECIFICATIONS AND REGISTRATION FEES
  976.                    MAY CHANGE WITHOUT NOTICE.
  977.           ____________________________________________
  978.  
  979.  
  980. ChkD  v1.1
  981.   Check_Disk_space reports disk drive space usage.  It reports drive
  982.   cluster size, then drive space TOTAL, FREE and USED by actual value
  983.   and by percentage.  It is faster and more convenient than the DOS
  984.   "dir" or "chkdsk" utilities for displaying drive information.
  985.  
  986. ChkM  v1.1
  987.   Check_Memory_space reports standard system memory (RAM) space usage.
  988.   It reports memory space TOTAL, FREE and USED by actual value and by
  989.   percentage.  It is faster and more convenient than the DOS "chkdsk"
  990.   utility for displaying system memory information.
  991.  
  992. CleanOut  v1.3
  993.   CLEANOUT searches all directories of the default drive for file(s)
  994.   specified on command line (wildcards * and ? are legal).  Each time
  995.   a matching file is found, the user is prompted for disposition:
  996.   Delete or Save.  File contents, either text or binary, can be VIEWED
  997.   before deciding.  A single press of the "S" key saves a file; a
  998.   double press of the "D" key deletes it.  An optional mode allows
  999.   deletions without confirmation.  Useful for cleaning out .BAK file
  1000.   leftovers, among others.
  1001.  
  1002. CleanTxt  v1.1
  1003.   CleanTxt converts WordStar text files to straight ASCII.  It strips
  1004.   out certain control characters, and will optionally expand tab
  1005.   characters to the appropriate number of spaces.
  1006.  
  1007. CleanZ  v1.2
  1008.   Most text editors won't read files beyond the first control-Z end-
  1009.   of-file character.  Control-Z's can become embedded in a text file
  1010.   when several files are combined using the DOS "type" command.
  1011.   CleanZ will strip out each control-Z, or it will optionally replace
  1012.   each with a seldom-used character, to ease the task of locating the
  1013.   former boundaries in combined files.
  1014.  
  1015. FindF  v1.1
  1016.   FindFile searches the default drive for specified files, and writes
  1017.   the file information to screen or disk. Useful for locating
  1018.   misplaced files or for generating a listing of all files and
  1019.   subdirectories on the default drive.
  1020.  
  1021. Gen  v1.2
  1022.   Gen replaces several trial-and-error methods of building specific-
  1023.   sized files for printer, storage or timing tests.  It generates
  1024.   files of any size from zero to twenty million bytes, much faster
  1025.   than typing random characters into a text editor.  Besides
  1026.   generating files on disk, it can send a specific number of
  1027.   characters directly to the console screen, printer or
  1028.   other DOS device.
  1029.  
  1030. KeyCode  v1.1
  1031.   KeyCode responds to each press of a key or combination of keys by
  1032.   displaying the key or combination pressed, its associated Ascii
  1033.   character (if any), key type (normal or extended), Ascii code and
  1034.   Scan code.
  1035.  
  1036. KeySet  v1.1
  1037.   KeySet's interactive mode displays the current settings of the
  1038.   CapsLock, NumLock, ScrollLock and PrtSc (Print Screen) keys, and
  1039.   allows them to be changed.  The command line mode directly sets the
  1040.   keys to specified states, allowing use of a batch file for
  1041.   presetting at system bootup or between applications.
  1042.  
  1043. PrinTest  v1.2
  1044.   PrinTest repetitively displays the status of ports assigned to
  1045.   parallel printer interfaces. It can be used to isolate problems to
  1046.   the printer interface card, the cable or the printer itself.  It
  1047.   reports printer and port number, status byte and status condition.
  1048.  
  1049. Qscr  v1.2
  1050.   QuickScreen converts a single text screen to an executable file for
  1051.   more rapid display.  The resulting .COM file will write a screen of
  1052.   text much faster than batch file ECHO statements.  Useful for
  1053.   setting up compact menu systems, demos and tutorials.
  1054.  
  1055. ScanF  v1.1
  1056.   Scan_File speeds up the search for ASCII text strings within
  1057.   executable files.  It filters out the unintelligible control and
  1058.   extended characters, allows user definition of minimum string length
  1059.   for display, and pauses after each screen of information.
  1060.  
  1061. ScanM  v1.1
  1062.   Scan_Memory speeds up the search for ASCII text such as ROM
  1063.   copyright statements and machine identification, anywhere within
  1064.   standard system memory space. It filters out the unintelligible
  1065.   control and extended characters, displays each string longer than
  1066.   three characters, and pauses after each screen of information.
  1067.  
  1068. Split  v1.1
  1069.   Split breaks huge text files down into smaller ones that will fit
  1070.   into your text editor or onto a diskette. Useful for working on
  1071.   large files with a limited-filesize memory-resident notepad utility.
  1072.  
  1073. StoRm  v1.1
  1074.   STOrage_RooM reports the amount of disk space required for storage
  1075.   of a specified file or group of files on any disk, using any version
  1076.   of DOS.  It takes into account all of the factors involved in
  1077.   determining file storage size.  It locates files specified on the
  1078.   command line and determines their actual total size and the amount
  1079.   of room needed to store them.  Useful for determining the number of
  1080.   files that will fit on a disk.
  1081.  
  1082. PhLBL  v0.75 (not yet released)
  1083.   Label printer using text stored in ASCII files.  Each label/card/
  1084.   tag can contain embedded commands for date, time, series (nn OF nn),
  1085.   consecutive serial numbering, left margin, and selectable printer
  1086.   attribute for each line; 5, 10, 12, 17 or 20 characters per inch
  1087.   pitch, normal/bold/underlined on Epson compatible dot-matrix
  1088.   printers.
  1089.  
  1090.  _______________________________________________________________
  1091. |                                                               |
  1092. |        COPYRIGHT 1989 Phil Herron.  ALL RIGHTS RESERVED.      |
  1093. |_______________________________________________________________|
  1094.