home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
High Voltage Shareware
/
high1.zip
/
high1
/
DIR4
/
QFND22.ZIP
/
QFINDDOC.TXT
< prev
next >
Wrap
Text File
|
1993-08-19
|
27KB
|
835 lines
Qfind
VERSION 2.2 - 08/19/93
Qfind Copyright 1991,1992, 1993 by JebSoft and James E. Bell
135 Gunlock Trace
Roswell, Georgia 30076
Electronic Mail on Compuserve: 70270,534
QFIND (Quick Find) is a set of utility programs that perform
the function of finding the location of a file or files on
your system. QFIND uses a different approach than most of
the file-finding programs available today.
FEATURES:
* Extremely fast file name search.
* Very easy to use.
* DOS Command line version of programs.
* Microsoft Windows 3.1 version of programs.
Qfind Version 2.0 - Page 2
Files included in QFND20.ZIP:
QFBUILD.EXE Builds file name database. DOS version
QFIND.EXE File finder utility. Command line version
QFBDLWIN.EXE Builds file name database. Windows version
QFINDWIN.EXE File finder utility - Windows version
THREE_D.DLL DLL file used in Qfindwin. This file
should be located in your Windows
directory
QFINDWIN.INI Initialization file for QFINDWIN
QFINDDOC.TXT Text version of documentation
QFINDDOC.WRI Windows Write version of documentation
QFINDHST.WRI History of changes for Qfind in Write
format
QFINDHST.TXT History of changes for Qfind in text
format
REGISTER.FRM Registration form
REGISTER.WRI Registration form in Windows Write format.
The following files are used by the Windows Install
program. They are only needed for the installation.
SETUPQF.EXE
SETUPKIT.DLL
VER.DLL
FILES.DAT
STARTUP.INI
Qfind Version 2.0 - Page 3
Qfind, like many DOS utilities, was born of necessity. I
needed to find "that file". I did not know which directory
contained the file, much less which disk contained the file.
I pulled out one of the existing file find utilities and
used it to search all my drives for "that file". After much
disk activity, I found the file. I needed to find another
file later and did the same thing. Most of my files (99.99%)
had not changed their location on my system between
searches. Why do all that disk activity each time I need to
find a file when most of the files are still in the same
location since the last time? Why not "remember" where all
the files are located and use that information for later
searches. If the file system has changed considerably since
the last search, just build the file database again and use
the new one to search.
Qfind is a file finding system that does just that. Qfbuild
builds a database that contains all files on all selected
drives on your system. The search programs (Qfind and
Qfindwin) then use that file to do their searches. This
results in extremely fast search times since the actual file
names in the disk directories are not needed again. On one
of my machines that has a 200 meg and a 120 meg drive and
10,000+ files, the search time is less than 3 seconds. On
another machine that has 2 32 meg logical drives, 8 network
drives and over 15,000 files, the search time is less than 4
seconds.
************************************************************
Installation:
All the files, except THREE_D.DLL and QFINDWIN.INI can be
located in any directory of your choice. QFINDWIN.INI must
be in the same directory as WIN.INI. THREE_D.DLL can be in
any directory specified in the path statement. The
recommended place is in the WINDOWS directory.
************************************************************
QFBUILD.EXE
Qfbuild is the DOS program that builds the database that
contains all the file names and directory names on selected
drives along with the optional switches for including Arc
and Zip files. . It is executed from the command line with
the following syntax....
QFBUILD [-z] [-a] first_drive next_drive etc....
The Arc and Zip switches must precede the drive letters.
The "[ ]" are not included on the actual command line. They
are here to show that these parameters are optional.
Qfind Version 2.0 - Page 4
If the -z switch is included, all ZIP files on the selected
drives are searched to include their files names in
Qfind.dat. The -a switch is for ARC files.
Examples:
QFBUILD -a c d e f g
This would build a Qfind.dat containing all files in
drives c, d, e, f, g and the internal directories of any
ARC files found on these drives.
QFBUILD -z e f g
This would build a Qfind.dat containing all files in
drives e, f, g and the internal directories of any ZIP
files found on these drives.
QFBUILD -a -z c: d: e: f: g:
This would build a Qfind.dat containing all files in
drives c, d, e, f, g and the internal directories of any
ARC and ZIP files found on these drives.
Qfbuild will take drive letters with or without the trailing
":" after the drive letter. The data file is built in the
order of the drives on the command line. If you need to
alter the order for some reason, just order the drives on
the command line as you wish.
Qfbuild sorts the file names in each subdirectory in
ascending order. This was done to make it easier to
visually read the output in Qfind or Qfindwin.
The inclusion of the -z and -a switch is recommended.
Qfind.dat would then contain all files on the selected disks
including the files contained in the ARC and ZIP files.
The only reason for leaving out the -z and -a switch on the
command line would be to make Qfind.dat smaller. Qfind and
QfindWin both have the ability to search for files either
including or excluding ARC and ZIP files.
Changing the location of the data file....
Normally, the data file is written to the root directory
of the C drive. If you need to change the location, add
the variable QFIND to the environment. The variable QFIND
is set to the drive and directory where you want the data
file to be located. Example....
Set QFIND=E:\QFIND
Qfind Version 2.0 - Page 5
QFBUILD will write the data file in the QFIND directory
on the E drive and QFIND will look there to find the
file.
***********************************************************
QFIND.EXE
Qfind is the command line version of the search program. It
is executed with the very simple syntax as follows....
QFIND [-x] [-g] search_mask
Example:
Qfind *.c
The above command will find all the .C files on all selected
drives and list them to the screen. I did not allow for
multiple search masks because the search is so fast and the
actual directory structure is not re-read for each search.
If you need to find files with another search mask, just re-
execute Qfind with the new search mask.
The -x switch must precede the search mask parameter, and is
used to exclude the search of the contents of any ARC or ZIP
files. If the -x switch is added to the command line, Qfind
will NOT search the contents of ARC or ZIP files.
NOTE - If QFIND.DAT was not created with the contents of ARC
or ZIP files selected, then Qfind cannot access the names in
those files. Therefore the -x switch would have no effect.
The -g switch provides a "GOTO" function to Qfind. If the -
g switch is selected, it will change the current drive and
the current directory to the drive and directory containing
the matched file name.
Example:
QFind -g xyz.exe
The current drive and current directory will be changed to
the drive and directory that contains the FIRST occurrence
of XYZ.EXE. If there are multiple copies of XYZ.EXE on your
system QFind selects the first one matched in the data file
built by QFBUILD. In this example, Qfind would also search
the contents of any ZIP or ARC files since the -x parameter
is omitted. If a file match were found in a ZIP file, Qfind
would change the drive and directory to the drive and
directory containing the ZIP file. If you don't want to
match names in the ZIP or ARC files, just place the -x
Qfind Version 2.0 - Page 6
switch along with the -g switch on the command line like
so....
Qfind -x -g xyz.exe
The search mask conforms to the standard DOS wildcard naming
convention.
Examples:
QFIND ???e???.* Will find all files with an "E" in the
4th character of the file name.
QFIND *.?X? Will find all files with an "X" in the
2nd character of the file type.
QFIND ?abc*.exe Will find all .EXE files with "ABC" in
the 2nd through the 4th position.
QFIND looks for the data file in the root directory of the C
drive unless the environment variable QFIND is set. See
QFBUILD for example.
QFIND will copy the selected files to the Windows clipboard.
Just select Copy from the menu, and the main window contents
will be copied to the clipboard.
The Find dialog box can be automatically brought up when
Qfindwin is launched. To select this feature, place a -f
parameter in the Qfindwin command line like so...
Go to Program manager and select the Qfind icon. Go to
File, Properties and add -f to the execution line.
Old execution line - QFINDWIN.EXE
New execution line - QFINDWIN.EXE -F
Qfindwin will now bring up the find dialog box when
launched.
************************************************************
QFBLDWIN.EXE
This is the Windows 3.1 version of the build program. It
can be launched by itself or from QFINDWIN.
To use QFBLDWIN, launch it from the program manager, file
manager, or QFINDWIN. It will present a shareware notice
(bypassed in the registered version) and then present you
with the main window. The windows controls are as follows:
Qfind Version 2.0 - Page 7
Drives - QFBLDWIN will display drives C thru Z and will grey
out any drives with higher than are present in your system.
If you have saved settings in the past, QFBLDWIN will check
the same boxes that you selected last time. Otherwise
QFBLDWIN will select all drives.
Search Arc Files
Search Zip Files
The settings control the inclusion of ARC or ZIP
directories. If they are checked, the respective ARC or ZIP
directories will be included in QFIND.DAT.
The inclusion of the ARC and ZIP directories is recommended.
Qfind.dat would then contain all files on the selected disks
including the files contained in the ARC and ZIP files. The
only reason for not selecting them would be to make
Qfind.dat smaller. Qfind and QfindWin both have the ability
to search for files either including or excluding ARC and
ZIP files.
Save Settings
If this box is checked the present settings (drive
selections, ARC and ZIP selections) are save in
QFINDWIN.INI.
OK
This will start the building of the new file database.
Cancel
Terminates the program without building a new database.
When you press OK, QFBLDWIN will present you with a dialog
box that shows you the running count of various files,
etc.. At this point, you can minimize QFBLDWIN and let it
do it's thing in the background.
If you click on the CANCEL button, QFBLDWIN will terminate
and leave the previous QFIND.DAT intact.
QFINDWIN.EXE
This is the Microsoft Windows 3.0/3.1 version of the search
program. It uses the same search mask conventions as QFIND
with an additonal feature.
There is a special syntax that will find a string anywhere
in the file name/file type. It is selected by not entering a
period in the search mask. It is as follows:
QFIND ab
Qfind Version 2.0 - Page 8
The above will find any file beginning with "ab". This is
the same as entering a mask of "ab*.*".
QFIND *ab
The above will find any file with "ab" anywhere in the file
name/file type. The above example would find files like
abxxxx.xxx or xab.xxx.xxx or xxxxxab.xxx or xxxxxxxx.abx.
To use QFINDWIN, execute it from Windows with either the
program manager or the file manager. It will display a
screen with "FIND", "BUILD", "COLOR", and HELP on the menu.
Click on FIND and a drop down menu will appear. It has the
following items:
Find This selection will display a dialog box asking
for the search mask.
About This selection will display the "About" dialog
box.
Exit This selection will exit the program.
Click on BUILD to launch QFBLDWIN and build a new file
database.
Click on COLOR the set the color settings of QFINDWIN. The
color menu consists of 2 items....
USE COLOR - This is a toggle. If a checkmark appears by
the USE COLOR, QFINDWIN will use color to display the
directory, file and zip entries. Otherwise bolding,
normal, and italic BLACK is used. To change the USE
COLOR setting, just click on the menu item. The check
will reverse state with each click.
SET COLOR - Clicking on this item will display the set
color dialog box. If USE COLOR is not checked, this
item will be grayed out and will not be selectable.
When this item is selected, it will present a set color
dialog box. To use the dialog box do the following....
Select the DIRECTORY, FILE, ZIPS/ARCS by clicking on the
appropiate button. This will set the 3 scroll bars to the
present value of this selection. Drag the scroll bars to
set the colors that you want. NOTE - On a 16 color system,
the colors will not change smoothly. On a 256 color system,
the change will be much smoother. Continue selecting each
file type and selecting the color combination for each.
Qfind Version 2.0 - Page 9
If the SAVE SETTINGS box is checked, these settings will be
saved in QFINDWIN.INI.
To search for files......
Click on Find and enter the search mask in the text box.
click on OK and the matched file names will appear in the
main box. If there are more matches than will fit in the
window, vertical scroll bars will appear. You can use
these vertical scroll bars to move the text around.
You can use the following scroll bar items.....
Scroll UP (UP arrow) - Each click will scroll the file
names UP one line.
Scroll DOWN (DOWN arrow) Each click will scroll the file
names DOWN one line
Scroll Page UP - Each click will scroll the file
UP one page.
Scroll Page DOWN - Each click will scroll the file
DOWN one page.
Move with Thumb - You can move the display of
file names back and forth with the thumb
control. The thumb control is the
little square box in the vertical scroll
bar. If you move the thumb to the half-
way location, the display of file names
will move down to the middle, etc.
Click on the ARC or ZIP checkbox to toggle the ARC and ZIP
file setting. If an "X" appears in the checkbox, QfindWin
will search for file name matches within ARC and ZIP files.
NOTE - If QFIND.DAT was not created with the contents of ARC
or ZIP files selected, then Qfindwin cannot access the names
in those files. Therefore the state of the checkboxes will
have no effect.
If the color option is not selected, the text is shown as
follows. DIRECTORY names are shown in bold font. FILE names
are shown in normal font. File names that are found within
ARC or ZIP files are shown in italic type with the ARC or
ZIP name shown surrounded by "**".
If the color option is selected, the text is shown in the
colors selected by the color setting selected in the SET
COLOR dialog box.
QFINDWIN.INI
Qfind Version 2.0 - Page 10
All parameters for QFINDWIN are located in this file.
QFINDWIN no longer looks in WIN.INI for anything.
QFINDWIN.INI must be located in the same directory as
WIN.INI.
There are 2 different sets of parameters contained in
QFINDWIN.INI. A set of parameters for QFINDWIN, and a set
for QFBLDWIN. All parameter, except for 1 (QFDIR) are
automatically set by the save settings function of QFINDWIN
and QFBLDWIN.
A sample QFINDWIN.INI file is included.
QFINDWIN uses the QFINDWIN.INI entry to find the data file
instead of the environment method. To tell QFINDWIN where
the data file is located, place the following 2 lines in the
QFINDWIN.INI file....
[qfind]
FILE = d:\temp OR wherever the data file is
located.
If there is no entry in the QFINDWIN.INI file, QFINDWIN will
look for the data file in the root directory of drive C.
Note........
THREE_D.DLL must be located in a directory that is defined
in your path for QFINDWIN to display in the 3D look. The
preferred location is in your Windows directory.
************************************************************
Support....
I can be reached on Compuserve. My ID is 70270,534
This is Version 2.0 of Qfind. I would appreciate feedback
on suggested additional features in the next version,
problems with this version, etc....
Qfind Version 2.0 - Page 11
Installation.......
With version 2.0 a new installation program is included.
This is only used if an automatic installation is desired.
There are basically 3 ways to install the Qfind
programs.......
If the DOS versions are the only things that are going to be
used, simply copy the required files to a directory of your
choice.
The files are:
Qfind.exe
Qfbuild.exe
Qfinddoc.txt
Qfindhst.txt
If you want to manually copy all files (including the
Windows stuff), do the following....
Copy the following files to a directory of your choice.
Qfind.exe
Qfbuild.exe
Qfindwin.exe
Qfbldwin.exe
Qfinddoc.txt
Qfinddoc.wri
Qfindhst.txt
Qfindhst.wri
Copy the following file to the \Windows\System directory
Three_D.Dll
Copy the following file to the \Windows directory
Qfindwin.ini
Automatic installation.....
Execute the SETUPQF.EXE from the program manager or file
manager. Setupqf will automatically install the various
file in the proper directories.
NOTE--- SETUPQF.EXE requires VISUAL BASIC's run-time
module (VBRUN100.DLL). If you don't have it, you can get
it from Compuserve.
Qfind Version 2.0 - Page 12
Registration
Registering QFIND will get you the latest version of the
programs along with a utility that will personalize your
copy and remove the start-up message in QFINDWIN.
Where to find QFIND:
The latest version of Qfind.zip can always be found on The
Atlanta Windows BBS. The BBS phone numbers are:
(404) 516-0048 (public) USR Dual Std w/fax 16,800 bps
(404) 516-9845 (private) USR Dual Standard 16,800 bps
(404) 516-9898 (private) USR Dual Standard 16,800 bps
(404) 516-9385 (public) USR Dual Std w/fax 16,800 bps
(404) 516-1773 (private) USR Dual Std w/fax 16,800 bps
(404) 516-1588 (public) USR Dual Std w/fax 16,800 bps
(404) 516-1883 (public) USR v.32 bis 14,400 bps
Also Qfind.zip can be found in the WINSHARE forum on
Compuserve.
Disclaimer:
Users of QFIND, QFINDWIN, QFBLDWIN, and QFBUILD must accept
this disclaimer of warranty: "QFIND, QFINDWIN, QFBLDWIN, and
QFBUILD are supplied as is. The author disclaims all
warranties, expressed or implied, including, without
limitation,the warranties of merchantability and of fitness
for any purpose. The author assumes no liability for
damages, direct or consequential, which may result from the
use of these programs."
LICENSING AGREEMENT:
QFIND, QFINDWIN, QFBLDWIN, AND QFBUILD are Copyright 1991,
1992 by JebSoft and James E. Bell 135 Gunlock Trace,
Roswell, Georgia 30076
This program is made available through Shareware for
personal use on non-business PC's only. If you find these
programs useful and find that you are using them and
continue to use them after a reasonable trial period, you
must make a registration payment of $10.00 to James E. Bell.
Use of this program by any business, corporation, government
agency, or any other institution is prohibited without
payment of $10.00 to James E. Bell for each installed PC.
In accordance with the Shareware distribution method, all
users are granted a limited license to copy QFIND, QFINDWIN,
QFBLDWIN ,and QFBUILD for the trial use of others providing
that there programs are:
Qfind Version 2.0 - Page 13
Copied in their original archive form.
Not modified in any way and are distributed with the
full and unmodified documentation.
Are not sold or traded for money or any other
consideration by any party other than JebSoft and James
E. Bell
Not distributed in conjunction with any other product
or software without the written consent of James E.
Bell.
Qfind Version 2.0 - Page 14