home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / utility / qfind14.zip / QFIND.DOC < prev    next >
Text File  |  1992-02-21  |  22KB  |  709 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                         Qfind
  14.  
  15.  
  16.                                 VERSION 1.4 - 1/25/92
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                Qfind Copyright 1991,1992 by JebSoft and James E. Bell
  23.  
  24.  
  25.                                   135 Gunlock Trace
  26.                                Roswell, Georgia  30076
  27.  
  28.  
  29.                       Electronic Mail on Compuserve: 70270,534
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                              Qfind Version 1.4 - Page 1
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.             QFIND (Quick Find) is a set of utility programs that perform
  71.             the function of finding the location of a file or files on
  72.             your system. QFIND uses a different approach than most of
  73.             the file-finding programs available today.
  74.  
  75.               FEATURES:
  76.  
  77.                *  Extremely fast file name search.
  78.  
  79.                *  Very easy to use.
  80.  
  81.                *  Command line version of search program.
  82.  
  83.                *  Microsoft Windows 3.0 version of search program.
  84.  
  85.  
  86.  
  87.  
  88.             Files included in QFND14.ZIP include:
  89.  
  90.  
  91.                QFBUILD.EXE       Builds file for searching from selected
  92.                                  disks.
  93.  
  94.                QFIND.EXE         File finder utility - Command line
  95.                                  version.
  96.  
  97.                QFINDWIN.EXE      File finder utility - Windows version.
  98.  
  99.                THREE_D.DLL       DLL file used in Qfindwin.  This file
  100.                                  should be located in your Windows
  101.                                  directory.
  102.  
  103.                QFINDWIN.INI      Initialization file for QFINDWIN. This
  104.                                  file must be located in you Windows
  105.                                  directory.
  106.  
  107.                QFIND.DOC         This file
  108.  
  109.                QFIND.HST         History of changes for Qfind.
  110.  
  111.                REGISTER.FRM      Registration form.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                              Qfind Version 1.4 - Page 2
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.             Qfind, like many DOS utilities, was born of necessity.  I
  130.             needed to find "that file".  I did not know which directory
  131.             contained the file, much less which disk contained the file.
  132.             I got out one of the existing file find utilities and used
  133.             it to search all my drives for "that file".  After much disk
  134.             activity, I found the file.  I needed to find another file
  135.             later and did the same thing. Most of my files (99.99%) had
  136.             not changed their location on my system between searches.
  137.             Why do all that disk activity each time I need to find a
  138.             file when most of the files are still in the same location
  139.             since the last time?  Why not "remember" where all the files
  140.             are located and use that data for later searches.  If the
  141.             file system has changed considerably since the last search,
  142.             just build the file database again and use the new one to
  143.             search.
  144.  
  145.             Qfind is a file finding system that does just that.  Qfbuild
  146.             builds a data file that contains all files on all selected
  147.             drives on your system. The search programs (Qfind and
  148.             Qfindwin) then use that file to do their searches.  This
  149.             results in extremely fast search times since the actual file
  150.             names in the disk directories are not read again.  On one of
  151.             my machines that has 6 32 meg logical drives and 5000+
  152.             files, the search time is less than 3 seconds.  On another
  153.             machines that has 2 32 meg logical drives, 8 network drives
  154.             and over 15,000 files, the search time is less than 5
  155.             seconds.
  156.  
  157.             ************************************************************
  158.  
  159.             Installation:
  160.  
  161.             All the files, except THREE_D.DLL and QFINDWIN.INI can be
  162.             located in any directory of your choice. QFINDWIN.INI must
  163.             be in the same directory as WIN.INI.  THREE_D.DLL can be in
  164.             any directory specified in the path statement. The
  165.             recommended place is in the WINDOWS directory.
  166.  
  167.  
  168.             ************************************************************
  169.  
  170.             QFBUILD.EXE
  171.  
  172.             Qfbuild is the program that builds the database that
  173.             contains all the file names and directory names on selected
  174.  
  175.  
  176.  
  177.  
  178.                              Qfind Version 1.4 - Page 3
  179.  
  180.  
  181.  
  182.  
  183.  
  184.             drives along with the optional switches for including Arc
  185.             and Zip files. .  It is executed from the command line with
  186.             the following syntax....
  187.  
  188.                QFBUILD [-z] [-a] first_drive next_drive next_drive
  189.                etc....
  190.  
  191.             The Arc and Zip switches must precede the drive letters.
  192.             The "[ ]" are not included on the actual command line.  They
  193.             are here to show that these parameters are optional.
  194.             If the -z switch is included, all ZIP files on the selected
  195.             drives will be searched to include their files names in
  196.             Qfind.dat.  The -a switch is for ARC files.
  197.  
  198.                Examples:
  199.  
  200.                QFBUILD  -a c d e f g
  201.  
  202.                This would build a Qfind.dat containing all files in
  203.                drives c, d, e, f, g and the internal directories of any
  204.                ARC files found on these drives.
  205.  
  206.                QFBUILD  -z  e f g
  207.  
  208.                This would build a Qfind.dat containing all files in
  209.                drives e, f, g and the internal directories of any  ZIP
  210.                files found on these drives.
  211.  
  212.                QFBUILD  -a -z c: d: e: f: g:
  213.  
  214.                This would build a Qfind.dat containing all files in
  215.                drives c, d, e, f, g and the internal directories of any
  216.                ARC and ZIP files found on these drives.
  217.  
  218.             Qfbuild will take drive letters with or without the trailing
  219.             ":"  after the drive letter.  The data file is built in the
  220.             order of the drives on the command line.  If you need to
  221.             alter the order for some reason, just order the drives on
  222.             the command line as you wish.
  223.  
  224.             Qfbuild sorts the file names in each subdirectory in
  225.             ascending order.  This was done to make it easier to
  226.             visually read the output in Qfind or Qfindwin.
  227.  
  228.             The inclusion of the -z and -a switch is recommended.
  229.             Qfind.dat would then contain all files on the selected disks
  230.             including the files contained in the ARC and ZIP files.
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.                              Qfind Version 1.4 - Page 4
  238.  
  239.  
  240.  
  241.  
  242.  
  243.             The only reason for leaving out the -z and -a switch on the
  244.             command line would be to make Qfind.dat smaller.  Qfind and
  245.             QfindWin both have the ability to search for files either
  246.             including or excluding ARC and ZIP files.
  247.  
  248.             Changing the location of the data file....
  249.  
  250.                Normally, the data file is written to the root directory
  251.                of the C drive.  If you need to change the location, add
  252.                the variable QFIND to the environment. The variable QFIND
  253.                is set to the drive and directory where you want the data
  254.                file to be located.  Example....
  255.  
  256.                     Set QFIND=E:\QFIND
  257.  
  258.                QFBUILD will write the data file in the QFIND directory
  259.                on the E drive and QFIND will look there to find the
  260.                file.
  261.  
  262.             ***********************************************************
  263.  
  264.             QFIND.EXE
  265.  
  266.             Qfind is the command line version of the search program.  It
  267.             is executed with the very simple syntax as follows....
  268.  
  269.                QFIND [-x] [-g] search_mask
  270.  
  271.                Example:
  272.  
  273.                Qfind *.c
  274.  
  275.             The above command will find all the .C files on all selected
  276.             drives and list them to the screen.  I did not allow for
  277.             multiple search masks because the search is so fast and the
  278.             actual directory structure is not re-read for each search.
  279.             If you need to find files with another search mask, just re-
  280.             execute Qfind with the new search mask.
  281.  
  282.             The -x switch must precede the search mask parameter, and is
  283.             used to exclude the search of the contents of any ARC or ZIP
  284.             files.  If the -x switch is added to the command line, Qfind
  285.             will NOT search the contents of ARC or ZIP files.
  286.  
  287.             If QFBUILD was not created with the contents of ARC or ZIP
  288.             files selected, then Qfind cannot access the names in those
  289.             files.  Therefore the -x switch would have no effect.
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.                              Qfind Version 1.4 - Page 5
  297.  
  298.  
  299.  
  300.  
  301.  
  302.             The -g switch is added to provide a "GOTO" function to
  303.             Qfind.  If the -g switch is selected, it will change the
  304.             current drive and the current directory to the drive and
  305.             directory containing the matched file name.
  306.  
  307.                Example:
  308.  
  309.                QFind -g xyz.exe
  310.  
  311.  
  312.             The current drive and current directory will be changed to
  313.             the drive and directory that contains the FIRST occurrence
  314.             of XYZ.EXE.  If there are multiple copies of XYZ.EXE on your
  315.             system QFind selects the first one matched in the data file
  316.             built by QFBUILD.  In this example, Qfind would also search
  317.             the contents of any ZIP or ARC files since the -x parameter
  318.             is omitted.  If a file match were found in a ZIP file, Qfind
  319.             would change the drive and directory to the drive and
  320.             directory containing the ZIP file.  If you don't want to
  321.             match names in the ZIP or ARC files, just place the -x
  322.             switch along with the -g switch on the command line like
  323.             so....
  324.  
  325.                Qfind -x -g xyz.exe
  326.  
  327.  
  328.             The search mask conforms to the standard DOS wildcard naming
  329.             convention.
  330.  
  331.               Examples:
  332.  
  333.              QFIND ???e???.*  Will find all files with an "E" in the
  334.                               4th character of the file name.
  335.  
  336.              QFIND *.?X?      Will find all files with an "X" in the
  337.                               2nd character of the file type.
  338.  
  339.              QFIND ?abc*.exe  Will find all .EXE files with "ABC" in
  340.                               the 2nd through the 4th position.
  341.  
  342.  
  343.             QFIND looks for the data file in the root directory of the C
  344.             drive unless the environment variable QFIND is set. See
  345.             QFBUILD for example.
  346.  
  347.  
  348.             ************************************************************
  349.  
  350.             QFINDWIN.EXE
  351.  
  352.  
  353.  
  354.  
  355.                              Qfind Version 1.4 - Page 6
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.             This is the Microsoft Windows 3.0 version of the search
  363.             program.  It uses the same search mask conventions as QFIND.
  364.  
  365.             To use QFINDWIN, execute it from Windows with either the
  366.             program manager or the file manager.  It will display a
  367.             screen with "FIND" on the menu.  Click on FIND and a drop
  368.             down menu will appear.  It has the following items:
  369.  
  370.  
  371.                Find  This selection will display a dialog box asking
  372.                      for the search mask.
  373.  
  374.                About This selection will display the "About" dialog
  375.                      box.
  376.  
  377.                Exit   This selection will exit the program.
  378.  
  379.  
  380.             To search for files......
  381.  
  382.                Click on Find and enter the search mask in the text box.
  383.                click on OK and the matched file names will appear in the
  384.                main box. If there are more matches than will fit in the
  385.                window, vertical scroll bars will appear.  You can use
  386.                these vertical scroll bars to move the text around.
  387.  
  388.             You can use the following scroll bar items.....
  389.  
  390.                Scroll UP (UP arrow) -    Each click will scroll the file
  391.                                          names UP one line.
  392.  
  393.                Scroll DOWN (DOWN arrow)  Each click will scroll the file
  394.                                          names DOWN one line
  395.  
  396.                Scroll Page UP  -         Each click will scroll the file
  397.                                          UP one page.
  398.  
  399.                Scroll Page DOWN -        Each click will scroll the file
  400.                                          DOWN one page.
  401.  
  402.                Move with Thumb -         You can move the display of
  403.                                          file names back and forth with
  404.                                          the thumb control.  The thumb
  405.                                          control is the little square
  406.                                          box in the vertical scroll bar.
  407.                                          If you move the thumb to the
  408.                                          half-way location, the display
  409.  
  410.  
  411.  
  412.  
  413.  
  414.                              Qfind Version 1.4 - Page 7
  415.  
  416.  
  417.  
  418.  
  419.  
  420.                                          of file names will move down to
  421.                                          the middle, etc.
  422.  
  423.             A checkbox for including ARC and ZIP files has been added to
  424.             QFindWin.  Click on the checkbox to toggle the ARC and ZIP
  425.             file setting.  If an "X" appears in the checkbox, QfindWin
  426.             will search for file name matches within ARC and ZIP files.
  427.  
  428.             If the color option is not selected, the text is shown as
  429.             follows. DIRECTORY names are shown in bold font.  FILE names
  430.             are shown in normal font.  File names that are found within
  431.             ARC or ZIP files are shown in italic type with the ARC or
  432.             ZIP name shown surrounded by "**".
  433.  
  434.             If the color options is selected the text is shown as
  435.             follows.  Directory names as shown in the Directory color
  436.             selection in QFINDWIN.INI.  File names are shown in the File
  437.             color selection in QFINDWIN.INI.  File name that are found
  438.             within ARC or ZIP files are shown in the ZIP color selection
  439.             in QFINDWIN.INI with the ARC or ZIP name shown surrounded by
  440.             "**".
  441.  
  442.             QFINDWIN.INI
  443.             A new file (QFINDWIN.INI) has been added in this version.
  444.             All parameters for QFINDWIN are now located in this file.
  445.             QFINDWIN no longer looks in WIN.INI for anything.
  446.             QFINDWIN.INI must be located in the same directory as
  447.             WIN.INI.
  448.  
  449.             There are 2 different sets of parameters contained in
  450.             QFINDWIN.INI. The file parameter is explained in the next
  451.             section.  The new COLOR parameters allow you to choose the
  452.             color option for display and to choose the colors that are
  453.             displayed.
  454.  
  455.             The COLOR parameter can have either of 2 values.
  456.  
  457.             Color=NO will select the bolding, and italic fonts for
  458.             display in black.
  459.             Color=YES will select colors for display.
  460.  
  461.             If the color option is selected, there are 3 parameters that
  462.             you can set to select the colors for each file type.
  463.  
  464.             The DIRECTORYCOLOR entry selects the color to display
  465.             directory names.
  466.             The FILECOLOR entry selects the color to display file names.
  467.             The ZIPCOLOR entry selects the color to display ZIP and ARC
  468.             file names.
  469.  
  470.  
  471.  
  472.  
  473.                              Qfind Version 1.4 - Page 8
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.             The format of these entries are as follows.
  481.  
  482.             Each entry contains 3 values, seperated by commas.  These
  483.             are the intensity values of the Red, Green, and Blue colors
  484.             in a range of 0 to 255.  0 is no intensity and 255 is max
  485.             intensity.  The values are in the order of RED, GREEN, BLUE.
  486.             You can set these values to any combination you want to
  487.             select different colors.  If you entry a number greater than
  488.             255, QFINDWIN will reject it, and select a default value.
  489.             NOTE - In a 16 color VGA system each primary color (RED,
  490.             GREEN, BLUE) only has 2 intensity values - Normal and
  491.             Bright.  Any value over 128 will select the High Intensity
  492.             color and any value of 128 or less will select the normal
  493.             intensity of that color.  In a 256 color system, the colors
  494.             will change with each smaller change in the values.
  495.  
  496.             QFINDWIN.INI might contain the following:
  497.  
  498.             [QFIND]
  499.             Color=YES
  500.             DirectoryColor=128,0,0
  501.             FileColor=128,0,128
  502.             ZipColor=0,128,0
  503.  
  504.             The color entry selects the color option.
  505.  
  506.             The DirectoryColor entry selects RED as the color for
  507.             Directory names.
  508.  
  509.             The FileColor entry selects magenta as the color for File
  510.             names.  Magenta is a color that uses a mix of RED and BLUE.
  511.  
  512.             The ZipColor entry select GREEN as the color for zip files.
  513.  
  514.             If the color entries are not defined in QFINDWIN.ZIP,
  515.             default colors will be selected.
  516.  
  517.             A sample QFINDWIN.INI file is included in this release.
  518.  
  519.             QFINDWIN uses the QFINDWIN.INI entry to find the data file
  520.             instead of the environment method.  To tell QFINDWIN where
  521.             the data file is located, place the following 2 lines in the
  522.             QFINDWIN.INI file....
  523.  
  524.             [qfind]
  525.                FILE = d:\temp     OR wherever the data file is located.
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.                              Qfind Version 1.4 - Page 9
  533.  
  534.  
  535.  
  536.  
  537.  
  538.             If there is no entry in the QFINDWIN.INI file, QFINDWIN will
  539.             look for the data file in the root directory of drive C.
  540.  
  541.             Note........
  542.             THREE_D.DLL must be located in a directory that is defined
  543.             in your path for QFINDWIN to display in the 3D look.  The
  544.             preferred location is in your Windows directory.
  545.  
  546.             ************************************************************
  547.  
  548.             Support....
  549.  
  550.                  I can be reached on Compuserve.  My ID is 70270,534
  551.  
  552.  
  553.             This is Version 1.4 of Qfind.  I would appreciate feedback
  554.             on suggested additional features in the next version,
  555.             problems with this version, etc....
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.                              Qfind Version 1.4 - Page 10
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.             Registration
  601.  
  602.             Registering QFIND will get you the latest version of the
  603.             programs along with a utility that will personalize your
  604.             copy and remove the start-up message in QFINDWIN.
  605.  
  606.  
  607.             Disclaimer:
  608.  
  609.             Users of QFIND, QFINDWIN, and QFBUILD must accept this
  610.             disclaimer of warranty: "QFIND, QFINDWIN, and QFBUILD are
  611.             supplied as is.  The author disclaims all warranties,
  612.             expressed or implied, including, without limitation,the
  613.             warranties of merchantability and of fitness for any
  614.             purpose.  The author assumes no liability for damages,
  615.             direct or consequential, which may result from the use of
  616.             these programs."
  617.  
  618.             LICENSING AGREEMENT:
  619.  
  620.             QFIND, QFINDWIN,  AND QFBUILD are Copyright 1991, 1992 by
  621.             JebSoft and James E. Bell 135 Gunlock Trace, Roswell,
  622.             Georgia  30076
  623.  
  624.             This program is made available through Shareware for
  625.             personal use on non-business PC's only.  If you find these
  626.             programs useful and find that you are using them and
  627.             continue to use them after a reasonable trial period, you
  628.             must make a registration payment of $10.00 to James E. Bell.
  629.  
  630.             Use of this program by any business, corporation, government
  631.             agency, or any other institution is prohibited without
  632.             payment of $10.00 to James E. Bell for each installed PC.
  633.  
  634.             In accordance with the Shareware distribution method, all
  635.             users are granted a limited license to copy QFIND, QFINDWIN,
  636.             and QFBUILD for the trial use of others providing that there
  637.             programs are:
  638.  
  639.                  Copied in their original archive form.
  640.  
  641.                  Not modified in any way and are distributed with the
  642.                  full and unmodified documentation.
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.                              Qfind Version 1.4 - Page 11
  651.  
  652.  
  653.  
  654.  
  655.  
  656.                  Are not sold or traded for money or any other
  657.                  consideration by any party other than JebSoft and James
  658.                  E. Bell
  659.  
  660.                  Not distributed in conjunction with any other product
  661.                  or software without the written consent of James E.
  662.                  Bell.
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.                              Qfind Version 1.4 - Page 12