home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
High Voltage Shareware
/
high1.zip
/
high1
/
DIR4
/
WRSIT189.ZIP
/
README.1ST
< prev
next >
Wrap
Text File
|
1993-10-01
|
14KB
|
273 lines
╔══════════════════════════════════════════════════════════════════════════╗
║ WHERE-IS-IT? ║
║ Ver 1.89 ║
║ ║
║ Fast File Finder Utility ║
║ By Brigham W. Thorp (c) 1993 ║
╚══════════════════════════════════════════════════════════════════════════╝
Thank you for trying out Where-Is-It? Version 1.89. I have made a lot of
enhancements to this program since Version 1.0 was released June 10, 1993.
I am very happy with the way the program has turned out so far. I will try
to get a few more features into the program within the next few weeks. Keep
your eyes open for the latest updates.
The basic idea behind this type of program is to search for files on
drives that would take a long time to find individually. It's actually MUCH
faster than using the Dos DIR /S switch due to the direct screen writes and
optimized code. It also gives you more options to choose from than Dos does
to. This program is relatively easy to use. Just type WHERE and it will
give you the command syntax and options.
-----------------------------------------------------------------------------
COMMAND SYNTAX:
-----------------------------------------------------------------------------
WHERE [Drive:][\Directory]<filespec or wildcard> /Options
The Drive is either a specified drive, or it could be left blank to
default to the current disk.
The directory is either none if you want the whole disk to be searched,
or it contains a directory name with the backslash.
The filespec or wildcard could be any legal DOS 8-dot-3 filename, or it
could be a wildcard, such as asterisks or question marks. Look in the DOS
manual if you are unfamiliar with wild cards. The options that alter the
search pattern are shown below.
-----------------------------------------------------------------------------
OPTIONS:
-----------------------------------------------------------------------------
/A or -A Search all available hard drives [C: - Z:]
/B or -B Pause when the screen fills up with files
/C or -C Display files and pathnames in upper case
/D or -D Delete found files (prompt for deletion)
/DY or -DY Delete found files (do NOT ask for confirmation)
/F or -F Full display - include directories in search
/I or -I Ignore WHERE environment variable
/K or -K Scan for different compressed file formats
/L or -L Send listing to file named WHERE.LOG
/N or -N Display filenames and pathnames only
/P or -P Search PATH environment variable for filespec
/R or -R Shows registration information
/Z or -Z Search for files with archive bit set
-----------------------------------------------------------------------------
EXAMPLES:
-----------------------------------------------------------------------------
WHERE C:\*.TXT Finds all .TXT on Drive C:
WHERE D:\*.?? Finds all 2 letter extensions on Drive D:
WHERE C:\DOS\*.EXE Finds all .EXE files in the DOS directory
and it's subdirectories
WHERE *.BAK /D Finds all .BAK files and prompts for deletion
WHERE *.TMP /DY /L Deletes all .TMP files without asking and sends
the output to WHERE.LOG
WHERE WI*.* /F Finds all files + directories starting with WI
WHERE *.BAT /A Search all hard drives for all .BAT files
WHERE *.DOC /Z Search for all .DOC files that have the Archive
bit set
WHERE *.* /B /F Search for all files and directories and pause
when the screen is full of files
WHERE *.* -K /A Search all hard drives for files compressed with
PK-Lite(tm), LZ-Exe(tm) or SQZ(tm).
WHERE *.DLL /P /D /L Search the PATH for all .DLL files while prompting
for deletion and sending the output to WHERE.LOG
(whew!)
-----------------------------------------------------------------------------
SAMPLE OUTPUT:
Command Line = WHERE C:\DOS\D*.COM
-----------------------------------------------------------------------------
Searching for d*.com in c:\dos\
diskcomp.com 10636 a 11/11/1991 5:00 c:\dos\
diskcopy.com 11879 11/11/1991 5:00 c:\dos\
doskey.com 5883 11/11/1991 5:00 c:\dos\
3 file(s) found occupying 28398 byte(s)
The first line tells you what the program is searching for. The following
lines are the files that matched the search pattern. If you look at one of
those lines, you will notice the filename, the size, the attributes, the
file date and time, and the path where the file is located. After all of the
files are listed, the total number of files is shown with the total amount
of space used for the found files.
Any time during the listing of the files you can press the ESCape key
to terminate the program. If you have the pagebreak option on, it will
exit after the next screenfull of information is shown.
-----------------------------------------------------------------------------
ENVIRONMENT VARIABLE:
-----------------------------------------------------------------------------
WHERE-IS-IT? supports an environment variable called WHERE. To set the
WHERE environment variable, at the Dos prompt type the following:
SET WHERE=-c
The above example sets as default the upper case display. If you notice,
there is no space between the name, the equals sign, and the first option.
If you have more than one option you would like stored in this variable,
you must put a space between all of the options like the example below:
SET WHERE=/c -d /p
The above example will search the path for a filespec that you specify
and will delete the files after asking for your confirmation. Also, the
output will be in upper case for the default.
You can put one of the lines above or one configured to your needs in
your autoexec.bat file. This will guarantee that the options you prefer will
always be there when you run WHERE-IS-IT?
It is also possible to override a switch that you have in your environment
variable. For example, if you had the environment variable set like the first
example above: SET WHERE=-c you can override that switch by typing another
-c on the command line. In fact, if you have an odd number of the option on
the command line, the option WILL be performed. If you have and even number,
then the option WILL NOT be performed.
-----------------------------------------------------------------------------
DETAILED OPTION HELP:
-----------------------------------------------------------------------------
/A : This option will search all logged hard drives [ A: - Z: ] for
a specified filespec. Due to the direct screen writes, this option
is very quick in displaying files, unlike Dos's DIR command.
/B : This option will pause the screen when it's full of files so you
can view the output a screen at a time. It will work no matter
what screen size you are working in (25, 43, or 50 line mode).
/C : This switch displays the filenames and pathnames in upper case.
I changed the output to lower case because people said it was
easier to read. If you like capital names better, use this
switch.
/D : This switch is used to delete the files matching the search
criteria. After the filename and other info is shown, a prompt
asks you if you wish to delete the file. You answer 'Y' for
Yes, 'N' for No or ESCape to quit. If the file is Read Only,
a second prompt will ask you if you are sure. Again, answer 'Y',
'N', or ESCape. If you are performing a deletion, the total number
of files and the number of bytes deleted will be shown at the end
of the listing. By the way, if a directory matches the search
criteria, it will be bypassed for deletion, but will still be shown.
/DY : This switch is just like the /D switch except that it doesn't ask
for your confirmation to delete the file. If the file is Read
Only, it will ask you if you are sure, but that is the only time,
so be extremely careful with this switch. The total number of files
deleted and the total size is also shown at the end of the search.
This switch will also show directories that match a filespec, but
will not let you delete them.
/F : This switch is used to display directory names that match the
search criteria. This option is off by default, as the display
can become very cluttered with directory names and files scrolling
down the screen. If you use this with the /D or /DY switch, any
matched directories will be shown, but you won't be able to delete
them.
/I : This switch ignores the settings in the WHERE environment variable.
Instead of having to override every option in the environment
variable with a command line switch, use this option to ignore
the environment variable altogether.
/K : This option will scan for files that are compressed with some
versions of PK-Lite(tm), LZ-Exe(tm), and SQZ(tm). These programs
compress a file so they take less disk space. When I get more
header formats for other compressed file types, I will put them
in as well. Some hack compression removal programs take the header
data out, so until I can figure out how to scan for these types of
files, you won't get accurate results if a file has been changed
by one of these programs.
/L : The /L switch is used to send the output that you see on the screen
to a log file named WHERE.LOG in the current directory. The exact
same info that is displayed on the screen will go into the log
file instead. If this is an unregistered version, the top of the
file will have 'UNREGISTERED VERSION' written to it.
/N : I put this option here after running a debugging program on this
program. It was spending too much time writing the attributes
and everything, so I made this option to only output the pathname
and filename. It is BLAZINGLY fast. Try it out.
/P : This switch is used to search the Path environment variable. If
the Path is empty, the program will state that and abort the
search. This is a useful command to find out if a filename
that you wish to execute is in your path or not. If used in
conjunction with the /A switch, this option takes precedence.
/R : This switch shows the registration screen only. It has my address
in it so you know how to contact me. If this is an unregistered
version, this screen will be displayed after a blank command
line is given, following the options help screen.
/Z : This option searches for files with the archive bit set. You
can use this option with the /A or /P switch to find these
files on all logged hard drives and the path respectively. You
can also use the /D or /DY switch to delete those found files.
-----------------------------------------------------------------------------
COMING SOON!
-----------------------------------------------------------------------------
------------ Hopefully this should be fairly soon! -----------
- Perform a command on all found files. I think it's going to look
something like this:
WHERE [disk:][\dir]<filespec> /S:command
For example, to run a program called DOIT, you would enter the
following command:
WHERE *.EXE /S:DOIT
------------------ Not as soon as you would like :( --------------
- Filename GREP. Search for any file that has "string" in it.
Ex.- WHERE "good" will find isgood.* , notgood.* , goodboy.*
and igood1.* for an example
- Exclude a certain GREP or filespec from the search.
Tell me what features you are looking for!
-----------------------------------------------------------------------------
REGISTRATION STUFF:
-----------------------------------------------------------------------------
This program is the result of long, hard work of myself, and registration
makes me work even harder. To date, there are over 2800 lines of code in this
version of Where-Is-It. That's pretty big for a full-time college student.
This program is copyrighted and reproduction and/or disassembly is a
violation of that copyright. If you register this product, you will receive
the current version on disk and the annoying little delay will go away.
Also, the writing of 'UNREGISTERED VERSION' to the WHERE.LOG file will not
be present.
Please support the shareware concept buy sending a donation of $10.00
for this program. If you are interested in the source code for this program,
please send $50 and I will send you the Pascal code for this program. Please
send check or money order only (NO CASH) to the address listed below. Also,
please let me know what version of WHERE-IS-IT you are currently using.
Brigham W. Thorp
12 Beaverbrook Road
West Simsbury, CT 06092
Internet Address
Thorp_brw@ctstate.ccsu.edu