home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / utils / fff.zip / FFF.DOC < prev    next >
Text File  |  1990-07-12  |  15KB  |  350 lines
  1.                        File Finder Pack
  2.                           Version 2.8
  3.                            07-11-90
  4.                               by
  5.                            Jim Derr
  6.  
  7.                            Member of
  8.                 Association of Shareware Professionals
  9.                        CSERVE ID 76266,2634
  10.  
  11.  
  12.     Please note this is a shareware product.  If you find these utilities
  13.     useful please register and keep shareware alive.  Only registered users
  14.     will be supported.  The fee is small and not unreasonable.
  15.  
  16.  
  17.                      FF2         FileFinder2
  18.     ----------------------------------------------------------------------
  19.     This program will find files on your hard disk.  It as fashioned after
  20.     the whereis program but has more features.
  21.  
  22.     Format is FF2 options [filespec filespec filespec....] options
  23.     Where options are:
  24.       /C    comma delimited listing
  25.       /R    raw listing - full path name only
  26.       /S    short listing - filename.ext only
  27.       /B    list in bat file format
  28.       /P    pause when screen is full
  29.       /Q    quite mode
  30.       /I    also look inside archive files
  31.       /A    only look inside archive files
  32.       /E    Extended Directory Search
  33.       /G    Greater or Equal to mm-dd-yy
  34.       /L    Less or Equal to mm-dd-yy
  35.       /SD   Single Directory search only (do not recurse)
  36.       /1    stop after finding one file
  37.             errorlevel 1 returned if no files found
  38.             errorlevel 0 returned if files are found
  39.       /Z[RHSA] Show files with specified attributes
  40.       /X"cmd" execute a cmd against all files found
  41.  
  42.     The filespec's that are specified on the command line can include a disk
  43.     and directory. If a disk and or directory is specified than the search
  44.     will be restricted to the specified disk and directory and any
  45.     sub-directories under the specified directory.  Each filespec can
  46.     contain different starting disks and directories.
  47.  
  48.     When specifing the file to search for FF2 has a quick complete
  49.     algorithm.  If you do not include a period in the file extension
  50.     FF2 will expand the filespec using the wildcard character ? for the
  51.     remainder of the filespec.  For example if you entered FF2 AB, FF2
  52.     will expand the filespec to AB??????.???.  If you enter FF2 C:\BAT\B
  53.     FF2 will expand the filespec to C:\BAT\B???????.???.  However if you
  54.     enter FF2 B.* , FF2 will not alter the filespec since you included a
  55.     period in the filespec.
  56.  
  57.     FF2 also has an expanded wild card search algorithm. If you include
  58.     an * on both sides of the filename, FF2 will find all files that
  59.     contain the characters entered between the *'s anywhere in the filename.
  60.     For example:
  61.  
  62.         FF2 *inst*
  63.  
  64.             This will find all files that contain inst somewhere in the
  65.             filename.  I.E.  D:\ANY\PINST.BAT
  66.                              C:\ONE\PCINSTAL.BAT
  67.                              C:\TWO\INSTALL.COM
  68.  
  69.         To find files with no extension include the period but no
  70.         file extension. I.E.  FF2 *me*.
  71.  
  72.  
  73.     If no disk or directory is included with the filespec than all hard
  74.     disks will be searched.
  75.  
  76.     FF2 now has the capability to automatically identify all hard disks
  77.     on your system.  You can over-ride this automatic detection by
  78.     setting the environment variable FF to the disk letter your wish the
  79.     search to be performed on.
  80.  
  81.     For example.  SET FF=CD tells FF2 to search the C and D drives if you
  82.     have not specified a disk in the filespec on the command line.
  83.  
  84.     All output from FF2 can be redirected or piped by using the DOS redirect
  85.     and pipe characters.
  86.  
  87.     The default output produced by FF2 file-size, file-date, file-time,
  88.     disk:\directory\filename.fileext. This can be changed by using the
  89.     following command line options:
  90.  
  91.     /C      Produces a comma delimited listing, this listing can be
  92.             imported into most spreadsheet and database programs.
  93.  
  94.     /R      Produces a raw listing containing disk:\directory\fn.ext only.
  95.  
  96.     /S      Produces a short listing containg filename.ext only.
  97.  
  98.     /B      Produces a listing that can be used as a bat file. The output
  99.             is as follows:
  100.             %1 filename.ext %2 %3 %4 %5 %6 %7 %8 %9
  101.  
  102.     /P      Will case a pause when the screen is full.
  103.  
  104.     /Q      Quite mode no output produced but results can be tested by using
  105.             the if errorlevel command in a .bat file.
  106.  
  107.     /I      This option tells FF2 to also look inside any archive files
  108.             for the indicated files.  The archive files that are supported
  109.             are ZIP, ARC, and LZH files.
  110.  
  111.     /A      This option tells FF2 to ONLY look inside archive files for
  112.             the indicated files.
  113.  
  114.     /1      This option tells FF2 to stop looking for files after it
  115.             finds the first file that matches the specified pattern.
  116.  
  117.     /E      To increase the file search process FF2 normally only looks
  118.             for directories that do not contain a file extension.  Using
  119.             this option tells FF2 to also look for directories that contain
  120.             directory names with extensions.
  121.  
  122.     /G      This option allows you to limit the file search to files that
  123.             have a filedate Greater than or Equal to the date specified.
  124.             The format is /Gmm-dd-yy.
  125.             I.E. /G01-01-90  or  /G1-1-90 will list files that have a
  126.                  filedate greater than or equal to 1-1-90.
  127.             (Note this option may be combined with the /L option to
  128.              specify a date range)
  129.  
  130.     /L      This option allows you to limit the file search to files that
  131.             have a filedate Less than or Equal to the date specified.
  132.             The format is /Lmm-dd-yy.
  133.             I.E. /L01-01-90  or  /L1-1-90 will list files that have a
  134.                  filedate less than or equal to 1-1-90.
  135.             (Note this option may be combined with the /G option to
  136.              specify a date range)
  137.  
  138.     /Z[RHSA]
  139.             This option allows you to limit the file search to files
  140.             that have specific attributes.  For example, specifying
  141.             /ZA will list files that have the archive attribute,
  142.             /ZRH will list files that have the read-only attribute OR
  143.                  the hidden attribute set.
  144.             **********************************************************
  145.             *PLEASE NOTE IF YOU SPECIFY THE /A OR /I OPTION THAN THIS*
  146.             *OPTIONS IS IGNORED.                                     *
  147.             **********************************************************
  148.  
  149.     /SD     This option informs FF2 to only search the directory that was
  150.             specified on the command line and not to search any directories
  151.             that exist under the specified directory.
  152.  
  153.  
  154.     /X"cmd" This options allows you to tell FF2 to execute a specified
  155.             against all files that are found.
  156.             For Example: /X"del &" will execute the delete command against
  157.             all file that were found.  The command can be any DOS command
  158.             or another program.  FF2 will insert the disk:\dir\fn.fext
  159.             of the found file into the command where you place the &
  160.             character.
  161.  
  162.             For example if you specify the following:
  163.  
  164.             /X"grep any & -s"
  165.  
  166.             and FF2 finds the file c:\data\any.doc it will execute the
  167.             following command:
  168.  
  169.             grep any c:\data\any.doc -s
  170.  
  171.             If you do not put the & in then FF2 will insert the found
  172.             filespec at the first blank in the command you specify, or at
  173.             the end of the command if no blanks exist.
  174.  
  175.  
  176.                      FFF         Fullscreen FileFinder
  177.     ----------------------------------------------------------------------
  178.     This program will find files on your hard disk, and present them in
  179.     a scrollable list.
  180.  
  181.     Format is FFF options [filespec filespec filespec....] options
  182.     Where options are:
  183.       /2    25 line mode display
  184.       /4    43 line mode display
  185.       /5    50 line mode display
  186.       /d    Search for dup files. (filename.ext only)
  187.       /D    Search for dup files. (filename.ext and file size)
  188.       /E    Extended Directory Search
  189.       /G    Greater or Equal to mm-dd-yy
  190.       /L    Less or Equal to mm-dd-yy
  191.       /I    also look inside archive files
  192.       /A    only look inside archive files
  193.             (THE ARCHIVE FILES THAT ARE SUPPORTED ARE ZIP,ARC, AND LZH)
  194.       /Z[RHSA] Show files with specified attributes
  195.       /SD   Single Directory search only (do not recurse)
  196.  
  197.  
  198.  
  199.     /I      This option tells FFF to also look inside any archive files
  200.             for the indicated files.  The archive files that are supported
  201.             are ZIP, ARC, and LZH files.
  202.  
  203.     /A      This option tells FFF to ONLY look inside archive files for
  204.             the indicated files.
  205.  
  206.     /d      This option tells FFF to search and display duplicate files.
  207.             Only the filename.ext will be used to determine duplicates.
  208.  
  209.     /D      This option is the same as the /d option except the filename.ext
  210.             and file size will be used to determine if a file is a dup.
  211.  
  212.     /E      To increase the file search process FFF normally only looks
  213.             for directories that do not contain a file extension.  Using
  214.             this option tells FFF to also look for directories that contain
  215.             directory names with extensions.
  216.  
  217.     /G      This option allows you to limit the file search to files that
  218.             have a filedate Greater than or Equal to the date specified.
  219.             The format is /Gmm-dd-yy.
  220.             I.E. /G01-01-90  or  /G1-1-90 will list files that have a
  221.                  filedate greater than or equal to 1-1-90.
  222.             (Note this option may be combined with the /L option to
  223.              specify a date range)
  224.  
  225.     /L      This option allows you to limit the file search to files that
  226.             have a filedate Less than or Equal to the date specified.
  227.             The format is /Lmm-dd-yy.
  228.             I.E. /L01-01-90  or  /L1-1-90 will list files that have a
  229.                  filedate less than or equal to 1-1-90.
  230.             (Note this option may be combined with the /G option to
  231.              specify a date range)
  232.  
  233.     /SD     This option informs FF2 to only search the directory that was
  234.             specified on the command line and not to search any directories
  235.             that exist under the specified directory.
  236.  
  237.     /Z[RHSA]
  238.             This option allows you to limit the file search to files
  239.             that have specific attributes.  For example, specifying
  240.             /ZA will list files that have the archive attribute,
  241.             /ZRH will list files that have the read-only attribute OR
  242.                  the hidden attribute set.
  243.             **********************************************************
  244.             *PLEASE NOTE IF YOU SPECIFY THE /A OR /I OPTION THAN THIS*
  245.             *OPTIONS IS IGNORED.                                     *
  246.             **********************************************************
  247.  
  248.  
  249.     The filespec's that are specified on the command line can include a disk
  250.     and directory. If a disk and or directory is specified than the search
  251.     will be restricted to the specified disk and directory and any
  252.     sub-directories under the specified directory.  Each filespec can
  253.     contain different starting disks and directories.
  254.  
  255.     When specifing the file to search for FFF has a quick complete
  256.     algorithm.  If you do not include a period and the file extension
  257.     FFF will expand the filespec using the wildcard character ? for the
  258.     remainder of the filespec.  For example if you entered FFF AB, FFF
  259.     will expand the filespec to AB??????.???.  If you enter FFF C:\BAT\B
  260.     FFF will expand the filespec to C:\BAT\B???????.???.  However if you
  261.     enter FFF B.* , FFF will not alter the filespec since you included a
  262.     period in the filespec.
  263.  
  264.     FFF also has an expanded wild card search algorithm. If you include
  265.     an * on both sides of the filename, FFF will find all files that
  266.     contain the characters entered between the *'s anywhere in the filename.
  267.     For example:
  268.  
  269.         FFF *inst*
  270.  
  271.             This will find all files that contain inst somewhere in the
  272.             filename.  I.E.  D:\ANY\PINST.BAT
  273.                              C:\ONE\PCINSTAL.BAT
  274.                              C:\TWO\INSTALL.COM
  275.  
  276.         To find files with no extension include the period but no
  277.         file extension. I.E.  FFF *me*.
  278.  
  279.  
  280.     If no disk or directory is included with the filespec than all hard
  281.     disks will be searched.
  282.  
  283.     FFF now has the capability to automatically identify all hard disks
  284.     on your system.  You can over-ride this automatic detection by
  285.     setting the environment variable FF to the disk letter your wish the
  286.     search to be performed on.
  287.  
  288.     For example.  SET FF=CD tells FFF to search the C and D drives if you
  289.     have not specified a disk in the filespec on the command line.
  290.  
  291.  
  292.     FFF will display all the files it found, up to it's internal maximum
  293.     of 3000 files, on the screen in a scrollable list.  You can use the
  294.     cursor keys, Pgup, Pgdn, HOME, END, CTL-HOME, and CTL-END to scroll
  295.     the list.  Pressing the ESC key will exit the program.
  296.  
  297.  
  298.                             HOT KEYS
  299.     ENTER or RETURN
  300.     Pressing the ENTER key will change the default disk and directory to
  301.     the one that contains the file currently highlited on the screen.
  302.  
  303.     F1
  304.     F1 will display the help panel.
  305.  
  306.     F2
  307.     Pressing the F2 key allows you to run any program you wish against the
  308.     currently highlited file.  A window will pop-up in which you must enter
  309.     program name that you wish to execute.  The program can be a DOS
  310.     internal program, i.e. del, rename, or any EXE, COM, or BAT file.  The
  311.     highlited filename is preloaded into the pop-up window for you.
  312.  
  313.     F3
  314.     F3 will delete the currently highlighted file.
  315.  
  316.     F4
  317.     F4 will delete all tagged files.
  318.  
  319.     F10
  320.     Pressing the F10 key will execute the program or BAT file currently
  321.     highlited on the screen. Before the Progam is executed FFF will
  322.     prompt you for any command line parameters that you want to pass to
  323.     the program. It will then change to the disk and directory that the
  324.     program is contained in, unload itself from memory and execute the
  325.     program.
  326.  
  327.     T
  328.     The T key will toggle the tagged status of the highlighted item.
  329.  
  330.     U
  331.     The U key will untag all tagged items.
  332.  
  333.     ALT-L
  334.     The ALT-L key will invoke Vern Buerg's List program on the highlighted
  335.     file.  The list.com program must be in the DOS path for this option to
  336.     function.
  337.  
  338.     ALT-Q
  339.     The ALT-Q key will invoke Sammy Mitchell's Qedit program on the
  340.     highlighted file.  The Q.EXE program must be in the DOS path for this
  341.     option to function.
  342.  
  343.  
  344.  
  345.  
  346.                              MONOCHROME MONITORS
  347.  
  348.     If you are using a monochrome monitor and the screen does not appear
  349.     correct set the environment variable MONO to a Y.  I.E. SET MONO=Y.
  350.