home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR4 / WRISIT32.ZIP / README.1ST < prev    next >
Text File  |  1994-01-18  |  16KB  |  315 lines
  1.  ╔══════════════════════════════════════════════════════════════════════════╗
  2.  ║                             WHERE-IS-IT?                                 ║
  3.  ║                               Ver  3.2                                   ║
  4.  ║                                                                          ║
  5.  ║                       Fast File Finder Utility                           ║
  6.  ║                    By Brigham W. Thorp   (c) 1994                        ║
  7.  ╚══════════════════════════════════════════════════════════════════════════╝
  8.  
  9.  
  10.    Welcome to WHERE-IS-IT? ver 3.2. This program was made to make your life
  11. easier. Have you ever wanted to find a file, but didn't know how to use
  12. the cryptic DOS commands? Well, that's one of my reasons for developing this
  13. program. It not only allows you to find files in general, but there are also
  14. many options which allow you to alter the search criteria, which hopefully
  15. will make life easier for you.
  16.  
  17.    This program has been developed in my spare time, while trying to finish
  18. my B.S. in Computer Science. I have spent over 50 hours writing this program
  19. and making changes to it since it was first released in June of 1993.
  20.  
  21.    A lot of people asked me why I was developing a program like this. To
  22. tell you the truth, there are hundreds of programs that find files, and
  23. I'm sure you might have one or two on your computer right now. The reason
  24. for doing this program was to increase my knowledge of PC compatible
  25. file manipulation and programming in general. Unfortunately, no college
  26. that I know of teaches you how to develop practical applications such as
  27. this, so I figured I would do it on my own. Here's to higher education!
  28.  
  29.    This document explains the options and the features of WHERE-IS-IT? I
  30. would kindly ask for you to experiment with this program for 30 days. If
  31. you find it useful, please register the program if you continue to use it.
  32. The file REGISTER.FRM has all the information about the price of registration
  33. and site licenses. I would like to thank you for experimenting with this
  34. version of WHERE-IS-IT?
  35.  
  36. -----------------------------------------------------------------------------
  37. COMMAND SYNTAX:
  38. -----------------------------------------------------------------------------
  39.  
  40.    WHERE <-Options> [Drive:][\Directory]<filespec or wildcard>... </Options>
  41.  
  42.    The <Drive> is either a specified drive, or it could be left blank to
  43. default to the current disk.
  44.  
  45.    The <Directory> is either none if you want the whole disk to be searched,
  46. or it contains a directory name with the backslash.
  47.  
  48.    The <filespec or wildcard> could be any legal DOS 8-dot-3 filename, or it
  49. could be a wildcard, such as asterisks or question marks. Look in the DOS
  50. manual if you are unfamiliar with wild cards.
  51.  
  52.    This version supports multiple filespecs, so if you wanted to search for
  53. *.doc and *.txt files, you could do something like this:
  54.  
  55.    WHERE <-Options> *.doc c:\temp\*.txt </Options>
  56.  
  57.    This example would find all doc files on the current disk and all txt
  58. files in the directory c:\temp. Note that each filespec can have it's own
  59. drive and directory as well.
  60.  
  61.    The options that alter the search pattern are shown below. Also, a full
  62. description of them can be found later in the document.
  63.  
  64.  
  65. -----------------------------------------------------------------------------
  66. OPTIONS:
  67. -----------------------------------------------------------------------------
  68.  
  69.   /A   :  Search all Hard Drives       /K   :  Check for Compressed Files
  70.   /B   :  Page Break                   /L   :  Output to WHERE.LOG File
  71.   /C1  :  Change to Dir of 1st Match   /N   :  Filenames + Pathnames Only
  72.   /CD  :  Change to Dir of Found File  /P   :  Search Path Environment
  73.   /D   :  Delete Files With Prompt     /R   :  Show Registration Information
  74.   /DY  :  Delete Files Without Prompt  /U   :  Uppercase Display
  75.   /F   :  Include Directories          /Z   :  Search for Set Archive Bit
  76.   /I   :  Ignore Environment Variable
  77.  
  78. -----------------------------------------------------------------------------
  79. EXAMPLES:
  80. -----------------------------------------------------------------------------
  81.  
  82.  
  83.    WHERE C:\*.TXT         Finds all .TXT on Drive C:
  84.    WHERE D:\*.??          Finds all 1 and 2 letter extensions on Drive D:
  85.    WHERE C:\DOS\*.EXE     Finds all .EXE files in the DOS directory
  86.                           and it's subdirectories
  87.  
  88.    WHERE *.BAK /D         Finds all .BAK files and prompts for deletion
  89.    WHERE *.TMP /DY /L     Deletes all .TMP files without asking and sends
  90.                           the output to WHERE.LOG
  91.  
  92.    WHERE WI*.* /F         Finds all files + directories starting with WI
  93.  
  94.    WHERE *.* /B /F        Search for all files and directories and pause
  95.                           when the screen is full of files
  96.    WHERE *.EXE -K /A      Search all hard drives for all .EXE files
  97.                           compressed with PK-Lite(tm) or LZ-Exe(tm)
  98.    WHERE *.DLL /P /D /L   Search the PATH for all .DLL files while prompting
  99.                           for deletion and sending the output to WHERE.LOG
  100.                           (whew!)
  101.  
  102.    WHERE *.TXT *.DOC -Z   Search for all .TXT and all .DOC files on the
  103.                           current disk that have the archive attribute set
  104.  
  105. -----------------------------------------------------------------------------
  106. SAMPLE OUTPUT:
  107. Command Line  =  WHERE C:\DOS\D*.COM
  108. -----------------------------------------------------------------------------
  109.  
  110. Searching for d*.com in c:\dos\
  111.  
  112. diskcomp.com     10636    a 11/11/1991     5:00  c:\dos\
  113. diskcopy.com     11879      11/11/1991     5:00  c:\dos\
  114.   doskey.com      5883      11/11/1991     5:00  c:\dos\
  115.  
  116. 3 file(s) found occupying 28,398 byte(s)
  117.  
  118.    The first line tells you what the program is searching for. The following
  119. lines are the files that matched the search pattern. If you look at one of
  120. those lines, you will notice the filename, the size, the attributes, the
  121. file date and time, and the path where the file is located. After all of the
  122. files are listed, the total number of files is shown with the total amount
  123. of space used for the found files.
  124.  
  125.  
  126.  
  127.    Any time during the listing of the files you can press the ESCape key
  128. to terminate the program.
  129.  
  130. -----------------------------------------------------------------------------
  131. ENVIRONMENT VARIABLE:
  132. -----------------------------------------------------------------------------
  133.  
  134.    WHERE-IS-IT? supports an environment variable called WHERE. To set the
  135. WHERE environment variable, at the DOS prompt type the following:
  136.  
  137.    SET WHERE=-u
  138.  
  139.    The above example sets as default the option -u. If you notice, there
  140. isn't a space between the name, the equals sign, and the first option.
  141. If you have more than one option you would like stored in this variable, 
  142. you must put a space between all of the subsequent options like the example
  143. shown below:
  144.  
  145.    SET WHERE=/u -d /p
  146.  
  147.    The above example will search the path for a filespec that you specify
  148. and will delete the files after asking for your confirmation. Also, the
  149. output will be in upper case for the default.
  150.  
  151.    You can put one of the lines above or one configured to your needs in
  152. your AUTOEXEC.BAT file. This will guarantee that the options you prefer will
  153. always be there when you run WHERE-IS-IT?
  154.  
  155.    It is also possible to override a switch that you have in your environment
  156. variable. For example, if you had the environment variable set like the first
  157. example above:  SET WHERE=-u  you can override that switch by typing another
  158. -u on the command line. In fact, if you have an odd number of the option on
  159. the command line, the option WILL be performed. If you have and even number,
  160. then the option WILL NOT be performed, because the options cancel each other
  161. out.
  162.  
  163.    In the version 1 series of WHERE-IS-IT?, you were allowed to put a
  164. filespec in the environment variable. This is NO LONGER ALLOWED. Please
  165. remember this when you set your desired environment variable.
  166.  
  167. -----------------------------------------------------------------------------
  168. DETAILED OPTION HELP:
  169. -----------------------------------------------------------------------------
  170.  
  171.    /A  :  This option will search all logged hard drives C: through Z: for
  172.           a specified filespec. This option is a lot better than DOS since
  173.           you can search multiple drives unlike the DIR command.
  174.  
  175.    /B  :  This option will pause the screen when it's full of files so you
  176.           can view the output a screen at a time. It will work no matter
  177.           what screen size you are working in (25, 43, or 50 line mode).
  178.  
  179.    /C1 :  This option allows you to change to the directory of the first
  180.           file to match the filespec or wildcard. After all of the files
  181.           matching the search criteria are displayed, the directory will
  182.           then be changed. If you use the -f show directories switch, the
  183.           directory matching is switched to, not the directory containing
  184.           the matched subdirectory. 
  185.  
  186.  
  187.  
  188.    /CD :  This switch allows you to change to the directory of the found
  189.           file. Each file that matches the search criteria is shown. A
  190.           prompt allows you to change to the directory of the file, continue
  191.           searching, or abort the search. Answer 'Y' to change the directory
  192.           and halt the program. Answer 'N' to continue the search, or enter
  193.           the ESCape key to cancel the operation and end the program without
  194.           changing the current directory. If you use the -f show directories
  195.           switch, the directory matching is switched to, not the directory
  196.           containing the matched subdirectory. 
  197.  
  198.    /D  :  This switch is used to delete the files matching the search
  199.           criteria. After the filename and other info is shown, a prompt
  200.           asks you if you wish to delete the file. You answer 'Y' for
  201.           Yes, 'N' for No or ESCape to quit. If the file is Read Only,
  202.           a second prompt will ask you if you are sure. Again, answer 'Y',
  203.           'N', or ESCape. If you are performing a deletion, the total number
  204.           of files and the number of bytes deleted will be shown at the
  205.           end of the listing. By the way, if you are using the /F show
  206.           directories option, the directories will be shown, but you won't
  207.           be able to delete them.
  208.  
  209.    /DY :  This switch is identical to the /D switch except that it doesn't
  210.           ask for your confirmation to delete the file. If the file is Read
  211.           Only, it will ask you if you are sure, but that is the only time,
  212.           so be extremely careful with this switch. The total number of files
  213.           deleted and the total size is also shown at the end of the search.
  214.           This switch will also show directories that match a filespec, but
  215.           will not let you delete them.
  216.  
  217.    /F  :  This switch is used to display directory names that match the
  218.           search criteria. This option is off by default, as the display
  219.           can become very cluttered with directory names and files scrolling
  220.           down the screen. If you use this with the /D or /DY switch, any
  221.           matched directories will be shown, but you won't be able to delete
  222.           them.
  223.  
  224.    /I  :  This switch ignores the settings in the WHERE environment variable.
  225.           Instead of having to override every option in the environment
  226.           variable with a command line switch, use this option to ignore
  227.           the environment variable altogether.
  228.  
  229.    /K  :  This option will scan for executable files that are compressed with
  230.           versions of PK-Lite(tm) and LZ-Exe(tm). These programs compress
  231.           executable files so they take less disk space. When I get more
  232.           header formats for other compressed file types, I will put them
  233.           in as well. Some hack compression removal programs take the header
  234.           data out, so until I can figure out how to scan for these types of
  235.           files, you won't get accurate results. I removed the SQZ(tm)
  236.           checking since this is an archive file, and I just want to stick
  237.           to executable file compressors.
  238.  
  239.    /L  :  The /L switch is used to send the output that you see on the screen
  240.           to a log file named WHERE.LOG in the current directory. The exact
  241.           same info that is displayed on the screen will go into the log
  242.           file instead. If this is an unregistered version, the top of the
  243.           file will have 'UNREGISTERED VERSION' written to it.
  244.  
  245.    /N  :  I put this option here after running a debugging program on this
  246.           program. It was spending too much time writing the attributes
  247.           and everything, so I made this option to only output the pathname
  248.           and filename. It is BLAZINGLY fast. Try it out.
  249.  
  250.  
  251.  
  252.    /P  :  This switch is used to search the Path environment variable. If
  253.           the Path is empty, the program will state that and abort the
  254.           search. This is a useful command to find out if a filename
  255.           that you wish to execute is in your path or not. If used in
  256.           conjunction with the /A switch, the /A option takes precedence.
  257.  
  258.    /R  :  This switch shows the registration screen only. It has my address
  259.           in it so you know how to contact me. If this is an unregistered
  260.           version, this screen will be displayed after a blank command
  261.           line is given, following the options help screen.
  262.  
  263.    /U  :  This switch displays the filenames and pathnames in upper case.
  264.           I changed the output to lower case because people said it was
  265.           easier to read. If you like capital names better, use this
  266.           switch.
  267.  
  268.    /Z  :  This option searches for files with the archive bit set. You
  269.           can use this option with the /A or /P switch to find these
  270.           files on all logged hard drives and the path respectively. You
  271.           can also use the /D or /DY switch to delete those found files.
  272.  
  273. -----------------------------------------------------------------------------
  274. COMING SOON!
  275. -----------------------------------------------------------------------------
  276.  
  277.    ------------     Hopefully this should be fairly soon!     -----------
  278.  
  279.   - Run a program on all found files. I was hoping to get that into this
  280.     version, but I started a co-op job through college and I haven't had
  281.     the time to get it in.
  282.  
  283.   - Support HPFS (OS/2) and NTFS (Win NT) with extended filenames as well.
  284.     This will take a while to get implemented and will increase the size
  285.     of the executable file enormously. I will need OS/2 and Win NT users
  286.     to beta test if anyone is interested.
  287.  
  288.   - Will search for the specified filespec inside of ZIP, ARJ, and LHA
  289.     archive file formats. This will be a while as well since I don't
  290.     have the code for these archive file types.
  291.  
  292.                 Tell me what features you are looking for!
  293.  
  294. -----------------------------------------------------------------------------
  295. REGISTRATION STUFF:
  296. -----------------------------------------------------------------------------
  297.  
  298.    This program is the result of long, hard work of myself, and registration
  299. makes me work even harder. To date, there are over 3000 lines of code in this
  300. version of WHERE-IS-IT. That's pretty big for a full-time college student
  301. who wrote this in his spare time.
  302.  
  303.    This program is copyrighted and reproduction and/or disassembly is a
  304. violation of that copyright. If you register this product, you will receive
  305. the current version on disk and the annoying little delay will go away.
  306. Also, the writing of 'UNREGISTERED VERSION' to the WHERE.LOG file will not
  307. be present.
  308.  
  309.    If you are interested in registering this program, please fill out the
  310. information in the file REGISTER.FRM. This form also has the current prices
  311. for personal and site license registration.
  312.  
  313. -----------------------------------------------------------------------------
  314. END OF DOCUMENT
  315.