home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / util2 / whiz1.lzh / WHIZREAD.ME < prev   
Text File  |  1988-01-31  |  11KB  |  271 lines
  1. (C) COPYRIGHT 1986, 1987, 1988 by S.B. Behman, The Whiz-ard; ALL RIGHTS RESERVED
  2.  
  3.                                   WHIZ
  4.                               INTRODUCTION
  5.  
  6.  
  7.  
  8.      WHIZ is the copyrighted property of S.B. Behman.  You are granted a
  9.      limited license to use WHIZ, and to copy it and distribute it,
  10.      provided that the following conditions are met:
  11.  
  12.      1) No fee may be charged for such copying and distribution.
  13.  
  14.      2) WHIZ may ONLY be distributed in its original, unmodified state.
  15.         To include WHIZ.EXE and WHIZREAD.ME.
  16.  
  17.  
  18.      Any voluntary contributions for the use of this program will be
  19.      appreciated, and should be sent to:
  20.  
  21.                         S.B. Behman, The Whiz-ard
  22.                            20581 Ashley Way
  23.                           Saratoga, CA 95070
  24.  
  25.      You may not use this product in a commercial environment or a
  26.      governmental organization without paying a license fee of $10.
  27.      Site licenses and commercial distribution licenses are available.
  28.  
  29.  
  30.  
  31.      A word about user supported software:
  32.  
  33.      The user supported software concept (usually referred to as freeware)
  34.      is an attempt to provide software at low cost.  The cost of offering a
  35.      new product by conventional means is staggering, and hence dissuades
  36.      many independent authors and small companies from developing and
  37.      promoting their ideas.  User supported software is an attempt to
  38.      develop a new marketing channel, where products can be introduced at
  39.      low cost.
  40.  
  41.      If user supported software works, then everyone will benefit.  The
  42.      user will benefit by receiving quality products at low cost, and by
  43.      being able to "test drive" software thoroughly before purchasing it.
  44.      The author benefits by being able to enter the commercial software
  45.      arena without first needing large sources of venture capital.
  46.  
  47.      But it can only work with your support.  We're not just talking about
  48.      WHIZ here, but about all user supported software.  If you find that you
  49.      are still using a program after a couple of weeks, then pretty
  50.      obviously it is worth something to you, and you should send in a
  51.      contribution.
  52.  
  53.  
  54.  
  55.                                ABOUT WHIZ
  56.  
  57.      WHIZ is a very high speed "Whereis".  It supports the "*" wildcard
  58.      in a better way than does DOS (see the examples below), it
  59.      shows all files matching the search argument, including "hidden" and
  60.      "system" files.
  61.  
  62.      Use WHIZ by entering:          WHIZ [d:]search_arg  [/on|/off]
  63.  
  64.      Files whose DOS "Archive" bit is set "on" are shown intensified.
  65.  
  66.      The /on & /off "switches" can be used on the command line to limit
  67.      the search to those files whose Archive bit is set "on" or "off"
  68.      respectively.  The default, absence of switches, includes all files
  69.      in the search.  So that:  "WHIZ C:* /ON"  will find all files on drive
  70.      C: whose Archive bit is on.  This list may be useful in making
  71.      "backup" decisions.
  72.  
  73.      If no drive (d:) is specified WHIZ searches all disks (fixed, floppy
  74.      and virtual) currently "on-line."  Floppy drives with their doors
  75.      open are not on-line. All paths on the specified drive(s) are
  76.      searched so that NO PATH SPECIFICATION IS PERMITTED.  An argument
  77.      that does not have a "." has an implicit trailing "*.*".
  78.  
  79.      Examples:
  80.      WHIZ *a*           all files with an "a" in the file name
  81.  
  82.      WHIZ *a*.          all files with an "a" in the file name and
  83.                         no extension (all blank extension)
  84.  
  85.      WHIZ a:*.com       all files on drive A: with a "com" extension
  86.  
  87.      WHIZ d:*.*??       all files on drive D: whose extension is at least
  88.                         2 non-blank characters long
  89.  
  90.                        NAVIGATING THE WHIZ DISPLAY
  91.  
  92.      Use the "pgup" and "pgdn" keys to review the selected files.  The use
  93.      of these keys prevents you from "going off the end" to the DOS
  94.      prompt.  The "space bar" is equivalent to pgdn except that when you
  95.      get to the last page it ends WHIZ and returns you to DOS.  At any
  96.      time "esc" causes an immediate exit.
  97.  
  98.      You may SORT the listed files by Filename, Extension, Date/time and
  99.      Size by pressing F2, F3, F4 and F5 respectively.  Pressing F1 shows a
  100.      help screen with a brief summary of this document.
  101.  
  102.      You may also create a file containing the listed files in one of two
  103.      output formats.  F9 formats exactly as seen on the screen.  F10
  104.      causes the output to be formated as one line for each file containing
  105.      ONLY the name information in the "DOS" format  "d:\path\name.ext".
  106.      This latter format could be handy for use in an editor to make a
  107.      "bat" file.  Size, date and time are omitted from this format to
  108.      facilitate editing.  These listings will be in the order as seen on
  109.      the screen.
  110.  
  111.                    USING THE $WHIZ$ "ENVIRONMENT VARIABLE"
  112.  
  113.     Many times it is desireable to look at a set of drives (e.g. "all
  114.     floppies" or "all hard disks" or "all disks") for a given file
  115.     specification.  Occasionally some drives should be avoided (e.g.
  116.     "network drives" or some Ramdisks which are not well behaved (the IBM
  117.     supplied "VDISK" works just fine, the AST VDISK doesn't!)  Providing
  118.     for such cases, WHIZ uses the "environment variable" $WHIZ$, if
  119.     present, to determine the meaning of the [d:] specification in the
  120.     search argument.
  121.  
  122.     If the Environment Variable $WHIZ$ is present, the drive letter
  123.     specification in the search argument ([d:]) will be used to "lookup"
  124.     the drive (or set of drives) to be searched in the $WHIZ$ environment
  125.     variable.  The correspondence established in $WHIZ$ will be used to
  126.     select the drives to be searched for the desired filename(s) as in the
  127.     following example.
  128.  
  129.           $WHIZ$=dce a:a b:b c:c d:d e:e f:ab z:dabce
  130.  
  131.      WHIZ *             will find all files on drives D:, C: and E: in
  132.                         the order all on D:, all on C: then all on E:
  133.                         because the "dce" following the "=" redefines
  134.                         the default drive set.  Similarly
  135.  
  136.      WHIZ f:*           will find all files on drives A: and B:
  137.                         because "F:" is defined as the set of drives
  138.                         "A:" and "B:" to WHIZ by the "f:ab "
  139.                         specification in the $WHIZ$ environment variable
  140.  
  141.      WHIZ *a*           all files on D:, C: and E: with an "a" in the
  142.                         filename
  143.  
  144.      WHIZ f:*.com       all files on A: and B: with a "com" extension
  145.  
  146.      "Environment Variables" can be set from the command line and, more
  147.      commonly, from your "AUTOEXEC.BAT" file.  So that adding a line like:
  148.  
  149.             SET $WHIZ$=dce a:a b:b c:c d:d e:e f:ab z:dabce
  150.  
  151.      to your AUTOEXEC.BAT file will make it available to WHIZ.
  152.  
  153.      NOTE: If you use the $WHIZ$ you MUST define ALL of the drive letters
  154.      you will use in it -- only those letters defined in $WHIZ$ will be
  155.      searched when $WHIZ$ has been specified.
  156.  
  157.                           BUGS AND ENHANCEMENTS
  158.  
  159.      Whiz works on all IBM PC's and on MOST "COMPATIBLES." Some
  160.      compatibles cannot handle the "multitrack" reads issued by WHIZ.
  161.  
  162.      Although WHIZ has been extensively tested it is considered a "work in
  163.      progress."  User feedback is HEARTILY WELCOMED!  Please send any
  164.      "bug" reports or suggestions for future enhancements to The Whiz-ard,
  165.      20581 Ashley Way, Saratoga, CA 95070.  Bugs will be fixed asap and
  166.      enhancements will be evaluated for inclusion in future releases.
  167.  
  168.                                  WHIZ LICENSE
  169.  
  170.      The use of WHIZ in a commercial environment or government organization
  171.      is granted under the following terms:
  172.  
  173.      1. Payment of the license fee must be made to S.B. Behman.  The fee
  174.         is based on the number of computers which will be used to run
  175.         WHIZ, as follows:
  176.  
  177.                1 to  9 copies  $10   each
  178.               10 to 24 copies  $7.50 each
  179.               25 to 49 copies  $6    each
  180.               50 to 99 copies  $4.50 each
  181.               over  99 copies  $400  one time fee
  182.  
  183.      2.  You may use WHIZ on the number of computers included in the license
  184.          fee.  If you have paid the fee for over 99 copies, then you may
  185.          use WHIZ on any number of computers within your organization.
  186.  
  187.      3.  You may make copies of the program, in its original,  unmodified
  188.          form,  without restriction.  You may distribute these copies of
  189.          the program without restriction.
  190.  
  191.      4.  If these copies are distributed outside of your organization,  you
  192.          have no obligation to control the use of those copies which are
  193.          outside of your organization.
  194.  
  195.      5.  You may make copies of the program documentation, in both its
  196.          printed form and machine readable form, without restriction.
  197.  
  198.      6.  You may use future versions of WHIZ under this license.  The latest
  199.          version is available from  The Whiz-ard for a $5 service charge.
  200.  
  201.      7.  You may NOT modify the program or charge a fee for copying or
  202.          distributing the program.
  203.  
  204.      8.  It is your responsibility to make the necessary copies and to
  205.          deliver them to the computers which they will be used on.
  206.  
  207.  
  208.  
  209.          I agree to abide by the terms and conditions of this license.
  210.  
  211.  
  212.          _____________________________         __________________________
  213.          Signature                             Date
  214.  
  215.          _____________________________
  216.          Name (please print or type)
  217.  
  218.          _____________________________
  219.          Title
  220.  
  221.          _____________________________
  222.          Company
  223.  
  224.  
  225.  
  226.  
  227.                                    ORDER FORM
  228.  
  229.  
  230.  
  231.      Check which items you wish to purchase:
  232.  
  233.          (_) Noncommercial license for the use of WHIZ.
  234.  
  235.          (_) Commercial license for the use of WHIZ on ___ computers (see
  236.              price schedule and terms on preceding page).
  237.  
  238.          (_) Program update subscription service (not more than three
  239.              updates, does not include trivial changes), $20/year.
  240.  
  241.          (_) Payment of $_____ is enclosed (check or money order).
  242.  
  243.  
  244.          _______________________________________________
  245.          Name
  246.  
  247.          _______________________________________________
  248.  
  249.  
  250.          _______________________________________________
  251.          Address
  252.  
  253.          ______________________   ________  ____________
  254.          City                     State     Zip
  255.  
  256.  
  257.  
  258.      Send this completed form to:
  259.  
  260.                             S.B. Behman
  261.                           20581 Ashley Way
  262.                           Saratoga, CA 95070
  263.  
  264.      For program disk orders outside the U.S., please add an additional $5,
  265.      and enclose an international money order payable in U.S. currency.
  266.  
  267.      For commercial site license orders, please enclose a signed copy of
  268.      the site license agreement.
  269.  
  270.  
  271.