home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR4 / W261.ZIP / WHERES.DOC next >
Text File  |  1993-10-27  |  4KB  |  138 lines
  1.  WHERES - File Find Utility v2.61
  2.    (c) Steven Kerr, 1993
  3.  
  4.  -----  
  5.  
  6.  WHERES is distributed as freeware, whch means that you can use it 
  7.  without charge, but sole ownership and copyright is retained by the
  8.  author. 
  9.  
  10.  -----  
  11.  
  12.  Thanks for taking the time to try WHERES! It's a small utility for 
  13.  finding files on your hard drive. The idea behind it is that it's both
  14.  simple to use and as fast as I could make it.
  15.  
  16.  -----  
  17.    
  18.  The syntax for WHERES is as follows :-
  19.  
  20.    WHERES Filename -Exclude /P /TString
  21.  
  22.  The parameters can be in any order except Filename, which must be first. 
  23.  I'll go through each of the parameters in turn.
  24.  
  25.  Filename :-
  26.    
  27.    You can tell WHERES which file(s) to search for in several different  
  28.    ways.
  29.  
  30.    1) Filename.Ext : For example, READ.ME
  31.    2) *.Ext        : For example, *.ME
  32.    3) Filename.*   : For example, READ.*
  33.    
  34.    In example 2, you can leave out the * wildcard and in example 3 you
  35.    can leave out the .* wildcard. WHERES will add both automatically.
  36.  
  37.    4) Filename.    : For example, README.
  38.  
  39.    Use the method shown in example 4 to search for files without extensions.
  40.    Note the trailing period.
  41.  
  42.  -Exclude :-
  43.  
  44.    Use this parameter to stop WHERES from searching certain drives. This
  45.    option is useful if you have network or CD-ROM drives on your system 
  46.    which you wouldn't normally want to search.
  47.  
  48.    You can exclude as many drives as you wish, just by adding more 
  49.    -Exclude parameters. For example, to exclude drives F: and G: from
  50.    the search, add -F -G to the command line.
  51.  
  52.  /P :-
  53.  
  54.    This parameter enables page pausing. This means that after a certain 
  55.    number of files have been found (usually 1 less than the number of 
  56.    lines you have your screen set to) a message will be displayed at the 
  57.    bottom :-
  58.  
  59.      ■ Hit a key for the next page or press Esc to abort...
  60.  
  61.    Giving you time to either look at the files that have been found or
  62.    abort the search. It's useful to be able to abort the search when 
  63.    WHERES is paused because on a powerful computer, it can be difficult 
  64.    to hit a key fast enough between pauses to abort the search.
  65.  
  66.    Note : WHERES' page pausing adusts automatically to whatever screen 
  67.           length you use.
  68.  
  69.  /TString :-
  70.  
  71.    This parameter will search each of the files found for the word
  72.    String and only display them if it is found. For example, to search
  73.    each file found for the word help, you would include /Thelp on the 
  74.    command line.
  75.  
  76.  -----
  77.  
  78.  An example of using WHERES is to search for WHERES.DOC, which you're
  79.  reading now. Assume, for example, that all you know about the file is
  80.  that it has a .DOC extension. The command line could be :-
  81.  
  82.    WHERES .DOC -E -F /P /TWheres
  83.            ┬── ┬─ ┬─ ┬─ ┬───────
  84.    1 ──────┘   │  │  │  │
  85.    2 ──────────┘  │  │  │
  86.    3 ─────────────┘  │  │
  87.    4 ────────────────┘  │
  88.    5 ───────────────────┘
  89.  
  90.      1) Search for *.DOC (WHERES adds the wildcard automatically).
  91.      2) Exclude drive E: from the search. For example a CD-ROM drive.
  92.      3) Exclude drive F: from the search. For example a network drive.
  93.      4) Enable page pausing in case lots of files are found. 
  94.      5) Search for the word Wheres in each file found.
  95.  
  96.  -----
  97.  
  98.  Error Messages :-
  99.  
  100.    There are none! Anything WHERES finds that it doesn't understand, it
  101.    ignores. This may seem a touch irresponsible at first, but as WHERES
  102.    doesn't actually modify any files on your hard disk at all, the only
  103.    possible problem is that it might not do exactly as you wanted. 
  104.    
  105.    For example, if you type :-
  106.      
  107.      WHERES -F -G /P *.TXT
  108.  
  109.      WHERES will search your hard disk(s) for the file '-F'. The 
  110.      solution is to abort and make sure the filename parameter comes
  111.      first.
  112.  
  113.  -----
  114.  
  115.  To see a brief help screen summarizing the above, run WHERES without
  116.  any command line parameters.
  117.  
  118.  -----
  119.  
  120.  If you need any further help, or have any comments or suggestions 
  121.  regarding WHERES, I can be contacted in the following ways :-
  122.  
  123.  EMail :-
  124.    
  125.    Internet : steven.kerr@almac.co.uk
  126.    Fidonet  : 2:259/27 or 2:259/17
  127.  
  128.  I can also be found in the echomail network ILINK in the SHAREWARE
  129.  conference.
  130.  
  131.  Postal Mail :-
  132.    
  133.    16 Spottiswoode Gardens
  134.    Mid Calder
  135.    West Lothian
  136.    EH53 OJU
  137.    SCOTLAND
  138.