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