home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR4 / WRSIT186.ZIP / README.1ST < prev    next >
Text File  |  1993-09-17  |  14KB  |  268 lines
  1.  ╔══════════════════════════════════════════════════════════════════════════╗
  2.  ║                             WHERE-IS-IT?                                 ║
  3.  ║                               Ver 1.86                                   ║
  4.  ║                                                                          ║
  5.  ║                       Fast File Finder Utility                           ║
  6.  ║                    By Brigham W. Thorp   (c) 1993                        ║
  7.  ╚══════════════════════════════════════════════════════════════════════════╝
  8.  
  9.    Thank you for trying out Where-It-It? Version 1.86. I have made a lot of
  10. enhancements to this program since Version 1.0 was released June 10, 1993.
  11. I am very happy with the way the program has turned out so far. I will try
  12. to get a few more features into the program within the next few weeks. Keep
  13. your eyes open for the latest updates.
  14.  
  15.    The basic idea behind this type of program is to search for files on
  16. drives that would take a long time to find individually. It's actually MUCH
  17. faster than using the Dos DIR /S switch due to the direct screen writes and
  18. optimized code. It also gives you more options to choose from than Dos does
  19. also. This program is relatively easy to use. Just type WHERE and it will
  20. give you the command syntax and options.
  21.  
  22. -----------------------------------------------------------------------------
  23. COMMAND SYNTAX:
  24. -----------------------------------------------------------------------------
  25.  
  26.    WHERE [Drive:][\Directory]<filespec or wildcard> /Options
  27.  
  28.    The Drive is either a specified drive, or it could be left blank to
  29. default to the current disk.
  30.  
  31.    The directory is either none if you want the whole disk to be searched,
  32. or it contains a directory name with the backslash.
  33.  
  34.    The filespec or wildcard could be any legal DOS 8-dot-3 filename, or it
  35. could be a wildcard, such as asterisks or question marks. Look in the DOS
  36. manual if you are unfamiliar with wild cards. The options that alter the 
  37. search pattern are shown below.
  38.  
  39. -----------------------------------------------------------------------------
  40. OPTIONS:
  41. -----------------------------------------------------------------------------
  42.  
  43.    /A   or   -A      Search all hard drives [C: - Z:]
  44.    /B   or   -B      Pause when the screen fills up with files
  45.    /C   or   -C      Display files and pathnames in upper case
  46.    /D   or   -D      Delete found files (prompt for deletion)
  47.    /DY  or   -DY     Delete found files (do NOT ask for confirmation)
  48.    /F   or   -F      Full display - include directories in search
  49.    /I   or   -I      Ignore WHERE environment variable
  50.    /K   or   -K      Search for PK-Lite(tm) and LZ-Exe(tm) compressed files
  51.    /L   or   -L      Send listing to file named WHERE.LOG
  52.    /P   or   -P      Search PATH environment variable for filespec
  53.    /R   or   -R      Shows registration information
  54.    /Z   or   -Z      Search for files with archive bit set
  55.  
  56. -----------------------------------------------------------------------------
  57. EXAMPLES:
  58. -----------------------------------------------------------------------------
  59.  
  60.    WHERE C:\*.TXT         Finds all .TXT on Drive C:
  61.    WHERE D:\*.??          Finds all 2 letter extensions on Drive D:
  62.    WHERE C:\DOS\*.EXE     Finds all .EXE files in the DOS directory
  63.                           and it's subdirectories
  64.  
  65.    WHERE *.BAK /D         Finds all .BAK files and prompts for deletion
  66.    WHERE *.TMP /DY /L     Deletes all .TMP files without asking and sends
  67.                           the output to WHERE.LOG
  68.  
  69.    WHERE WI*.* /F         Finds all files + directories starting with WI
  70.    WHERE *.BAT /A         Search all hard drives for all .BAT files
  71.    WHERE *.DOC /Z         Search for all .DOC files that have the Archive
  72.                           bit set
  73.  
  74.    WHERE *.* /B /F        Search for all files and directories and pause
  75.                           when the screen is full of files
  76.  
  77.    WHERE *.DLL /P /D /L   Search the PATH for all .DLL files while prompting
  78.                           for deletion and sending the output to WHERE.LOG
  79.                           (whew!)
  80.  
  81. -----------------------------------------------------------------------------
  82. SAMPLE OUTPUT:
  83. Command Line  =  WHERE C:\DOS\D*.COM
  84. -----------------------------------------------------------------------------
  85.  
  86. Searching for d*.com in c:\dos\
  87.  
  88. diskcomp.com     10636    a 11/11/1991     5:00  c:\dos\
  89. diskcopy.com     11879      11/11/1991     5:00  c:\dos\
  90.   doskey.com      5883      11/11/1991     5:00  c:\dos\
  91.  
  92. 3 file(s) found occupying 28398 byte(s)
  93.  
  94.  
  95.    The first line tells you what the program is searching for. The next 3
  96. lines after that are the files that matched the search pattern. If you
  97. look at one of those lines, you will notice the filename, the size, the
  98. attributes, the file date and time, and the path where the file is located.
  99. After all of the files are listed, the total number of files is shown with
  100. the total amount of space used for the found files.
  101.  
  102.    Any time during the listing of the files you can press the ESCape key
  103. to terminate the program. If you have the pagebreak option on, it will
  104. exit after the next screenfull of information is shown.
  105.  
  106. -----------------------------------------------------------------------------
  107. ENVIRONMENT VARIABLE:
  108. -----------------------------------------------------------------------------
  109.  
  110.    WHERE-IS-IT? now supports an environment variable called WHERE. To set
  111. the WHERE environment variable, at the Dos prompt type the following:
  112.  
  113.    SET WHERE=-c
  114.  
  115.    The above example sets as default the upper case display. If you notice,
  116. there is no space between the name, the equals sign, and the first option.
  117. If you have more than one option you would like stored in this variable, 
  118. you must put a space between all of the options like the example below:
  119.  
  120.    SET WHERE=/c -d /p
  121.  
  122.    The above example will search the path for a filespec that you specify
  123. and will delete the files after asking you Yes or No. Also. the output
  124. will be in upper case for the default.
  125.  
  126.    You can put one of the lines above or one configured to your needs in
  127. your autoexec.bat file. This will guarantee that the options you prefer will
  128. always be there when you run WHERE-IS-IT?
  129.  
  130.    It is also possible to override a switch that you have in your environment
  131. variable. For example, if you had the environment variable set like the first
  132. example above: SET WHERE=-c  you can override that switch by typing another
  133. -c on the command line. In fact, if you have an odd number of the option on
  134. the command line, the option WILL be performed. If you have and even number,
  135. then the option WILL NOT be performed.
  136.  
  137. -----------------------------------------------------------------------------
  138. DETAILED OPTION HELP:
  139. -----------------------------------------------------------------------------
  140.  
  141.    /A  :  This option will search all logged hard drives [ A: - Z: ] for
  142.           a specified filespec. Due to the direct screen writes, this option
  143.           is very quick in displaying files, unlike Dos's DIR command.
  144.  
  145.    /B  :  This option will pause the screen when it's full of files so you
  146.           can view the output a screen at a time. It will work no matter
  147.           what screen size you are working in (25, 43, or 50 line mode).
  148.  
  149.    /C  :  This switch displays the filenames and pathnames in upper case.
  150.           I changed the output to lower case because people said it was
  151.           easier to read. If you like capital names better, use this
  152.           switch.
  153.  
  154.    /D  :  This switch is used to delete the files matching the search
  155.           criteria. After the filename and other info is shown, a prompt
  156.           asks you if you wish to delete the file. You answer 'Y' for
  157.           Yes or 'N' for No or ESCape to quit. If the file is Read Only,
  158.           a second prompt will ask you if you are sure. Again, answer 'Y',
  159.           'N', or ESCape. If you are performing a deletion, the total number
  160.           of files and the number of bytes deleted will be shown at the end
  161.           of the listing. By the way, if a directory matches the search
  162.           criteria, it will be bypassed for deletion, but will still be shown.
  163.  
  164.    /DY :  This switch is just like the /D switch except that it doesn't ask
  165.           for your confirmation to delete the file. If the file is Read
  166.           Only, it will ask you if you are sure, but that is the only time,
  167.           so be extremely careful with this switch. The total number of files
  168.           deleted and the total size is also shown at the end of the search.
  169.           This switch will also show directories that match a filespec, but
  170.           will not let you delete them.
  171.  
  172.    /F  :  This switch is used to display directory names that match the
  173.           search criteria. This option is off by default, as the display
  174.           can become very cluttered with directory names and files scrolling
  175.           down the screen. If you use this with the /D or /DY switch, any
  176.           matched directories will be shown, but you won't be able to delete
  177.           them.
  178.  
  179.    /I  :  This switch ignores the settings in the WHERE environment variable.
  180.           Instead of having to override every option in the environment
  181.           variable with a command line switch, use this option to ignore
  182.           the environment variable altogether.
  183.  
  184.    /K  :  This option will scan for files that are compressed with some
  185.           versions of PK-Lite(tm) or LZ-Exe(tm). These programs compress
  186.           a file so they take less disk space. When I get more header
  187.           formats for newer compressed file types, I will put them in
  188.           as well. Some hack compression removal programs take the
  189.           header data out, so until I can figure out how to scan for these
  190.           types of files, you won't get accurate results if a file has had
  191.           it's header data removed by one of these programs.
  192.  
  193.    /L  :  The /L switch is used to send the output that you see on the screen
  194.           to a log file named WHERE.LOG in the current directory. The exact
  195.           same info that is displayed on the screen will go into the log
  196.           file instead. If this is an unregistered version, the top of the
  197.           file will have 'UNREGISTERED VERSION' written to it.
  198.  
  199.    /P  :  This switch is used to search the Path environment variable. If
  200.           the Path is empty, the program will state that and abort the
  201.           search. This is a useful command to find out if a filename
  202.           that you wish to execute is in your path or not. If used in
  203.           conjunction with the /A switch, this option takes precedence.
  204.  
  205.    /R  :  This switch shows the registration screen only. It has my address
  206.           in it so you know how to contact me. If this is an unregistered
  207.           version, this screen will be displayed after a blank command
  208.           line is given, following the options help screen.
  209.  
  210.    /Z  :  This option searches for files with the archive bit set. You
  211.           can use this option with the /A or /P switch to find these
  212.           files on all logged hard drives and the path respectively. You
  213.           can also use the /D or /DY switch to delete those found files.
  214.  
  215. -----------------------------------------------------------------------------
  216. COMING SOON!
  217. -----------------------------------------------------------------------------
  218.  
  219.    ------------     Hopefully this should be fairly soon!     -----------
  220.  
  221.       Perform a command on all found files. I think it's going to look
  222.        something like this:
  223.  
  224.                  WHERE [disk:][\dir]<filespec> /S:command
  225.  
  226.        For example, to run a program called DOIT, you would enter the
  227.        following command:
  228.  
  229.                  WHERE *.EXE /S:DOIT
  230.  
  231.    ------------------ Not as soon as you would like  :(   --------------
  232.  
  233.       Filename GREP. Search for any file that has "string" in it.
  234.        Ex.-  WHERE "good" will find isgood.* , notgood.* , goodboy.*
  235.              and igood1.* for an example
  236.  
  237.       Exclude a certain GREP or filespec from the search.
  238.  
  239.                 Tell me what features you are looking for!
  240.  
  241. -----------------------------------------------------------------------------
  242. REGISTRATION STUFF:
  243. -----------------------------------------------------------------------------
  244.  
  245.  
  246.    This program is the result of long, hard work of myself, and registration
  247. makes me work even harder. To date, there are over 2300 lines of code in this
  248. version of Where-It-It. That's pretty big for a full-time college student.
  249.  
  250.    This program is copyrighted and reproduction and/or disassembly is a
  251. violation of that copyright. If you register this product, you will receive
  252. the current version on disk and the annoying little delay will go away.
  253. Also, the writing of 'UNREGISTERED VERSION' to the WHERE.LOG file will not
  254. be present.
  255.  
  256.    Please support the shareware concept buy sending a donation of $10.00
  257. for this program. If you are interested in the source code for this program,
  258. please send $50 and I will send you the Pascal code for this program. Please
  259. send check or money order only (NO CASH) to the address listed below. Also,
  260. please let me know what version of WHERE-IS-IT you are currently using.
  261.  
  262.                           Brigham W. Thorp
  263.                         12 Beaverbrook Road
  264.                      West Simsbury, CT   06092
  265.  
  266.                           Internet Address
  267.                      Thorp_brw@ctstate.ccsu.edu
  268.